BRL.System: | Functions | Modinfo | Source |
Function Confirm( text$,serious=False ) | |
Returns | True or False depending on the user's selection. |
Description | Request user confirmation. |
Information | Confirm activates a simple user interface element requesting the user to select between
YES and NO options. If the user selects YES, then Confirm returns True. Otherwise,
False is returned. Note that a user interface may not be available when in graphics mode on some platforms. |
Example | ' confirm.bmx result=Confirm("Are you sure?") print result |
Function CurrentDate$() | |
Returns | The current date as a string. |
Description | Get current date. |
Information | Returns the current date in the format: DD MON YYYY (i.e. 10 DEC 2000). |
Example | ' currentdate.bmx Print "The date is "+CurrentDate$() |
Function CurrentTime$() | |
Returns | The current time as a string. |
Description | Get current time. |
Information | Returns the current time in the format: HH:MM:SS (i.e. 14:31:57). |
Example | ' currenttime.bmx Print "The time is "+CurrentTime$() |
Function HideMouse() | |
Description | Make the mouse pointer invisible. |
Function MoveMouse( x,y ) | |
Description | Move mouse pointer. |
Information | MoveMouse positions the mouse cursor at a specific location within the current window or graphics display. |
Function Notify( text$,serious=False ) | |
Description | Notify user. |
Information | Notify activates a simple user interface element informing the user of an event.
The optional serious flag can be used to indicate a 'critical' event. Note that a user interface may not be available when in graphics mode on some platforms. |
Example | ' notify.bmx Notify "Hello World" |
Function OpenURL( url$ ) | |
Description | Opens a URL with the system's default web browser. |
Information | Note that a user interface may not be available when in graphics mode on some platforms. |
Function PollSystem() | |
Description | Poll operating system. |
Information | PollSystem returns control back to the operating system, allowing such
events as keystrokes and gadget actions to be processed. Control is then
returned back to your program. If PollSystem encounters a key, mouse or app suspend/resume/terminate event, and equivalent BlitzMax Event will be generated which may be examined using the SYSTEMEVENTHOOK hook. |
Function Proceed( text$,serious=False ) | |
Returns | 1, 0 or -1 depending on the user's selection. |
Description | Request user confirmation or cancellation. |
Information | Proceed activates a simple user interface element requesting the user to select between
YES, NO and CANCEL options. If the user selects YES, then Proceed return 1. If the user
selects NO, then Proceed returns 0. Otherwise, Proceed returns -1. Note that a user interface may not be available when in graphics mode on some platforms. |
Example | ' proceed.bmx result=Proceed("Are you sure you want to continue?") print result |
Function RequestDir$( text$,initial_path$="" ) | |
Returns | The path of the selected folder or an empty string if the operation was cancelled. |
Description | Display system folder requester. |
Information | text is used as the title of the file requester. initial_path is the initial path for the folder requester. Note that a user interface may not be available when in graphics mode on some platforms. |
Example | ' requestdir.bmx path$=RequestDir("Select a Folder",CurrentDir()) Print "directory selected was "+path |
Function RequestFile$( text$,extensions$="",save_flag=False,initial_path$="" ) | |
Returns | The path of the selected file or an empty string if the operation was cancelled. |
Description | Display system file requester. |
Information | text is used as the title of the file requester. The optional extensions string can either be a comma separated list of file extensions or as in the following example groups of extensions that begin with a "group:" and separated by a semicolon. save_flag can be True to create a save-style requester, or False to create a load-style requester. initial_path is the initial path for the file requester. Note that a user interface may not be available when in graphics mode on some platforms. |
Example | ' requestfile.bmx filter$="Image Files:png,jpg,bmp;Text Files:txt;All Files:*" filename$=RequestFile( "Select graphic file to open",filter$ ) Print filename |
Function ShowMouse() | |
Description | Make the mouse pointer visible. |
Function WaitSystem() | |
Description | Wait for operating system. |
Information | WaitSystem returns control back to the operating system, waiting until
an event such as a keystroke or gadget action occurs. Note that WaitSystem may wait indefinitely if there is no possibility of any events occuring, so use with caution. If WaitSystem encounters a key, mouse or app suspend/resume/terminate event, and equivalent BlitzMax Event will be generated which may be examined using the SYSTEMEVENTHOOK hook. |
Version | 1.17 |
---|---|
Author | Mark Sibly, Simon Armstrong |
License | Blitz Shared Source Code |
Copyright | Blitz Research Ltd |
Modserver | BRL |
History | 1.17 Release |
History | OpenURL now attempts to fully qualify file / http url supplied |
History | 1.16 Release |
History | Fixed MacOS RequestFile to respect wild card filter |
History | 1.15 Release |
History | Fixed mouse hidden by default |
History | 1.14 Release |
History | Fixed HideMouse causing mouse to disappear when in non-client areas |
History | 1.13 Release |
History | Fixed Linux MoveMouse to be relative to the origin of the current Graphics window |
History | 1.12 Release |
History | Added Linux X11 import to remove glgraphics.mod dependency |
History | Fixed linux middle button crash |
History | 1.11 Release |
History | Fixed win32 clipboard glitches with QS_ALLINPUT bbSystemWait mod |
History | 1.11 Release |
History | CGSetLocalEventsSuppressionInterval fix for MacOS bbSystemMoveMouse |
History | 1.10 Release |
History | Ripped out input stuff and added hook |
History | 1.09 Release |
History | Tweaked MacOS GetChar() |
History | 1.07 Release |
History | Added AppTitle support for requesters |
History | 1.06 Release |
History | Fixed MacOS RequestDir ignoring initial path |
History | 1.05 Release |
History | Added RequestDir support for MacOS |
History | 1.04 Release |
History | Added mouse capture to Win32 |
History | Fixed C Compiler warnings |