BRL.System:

Функции

Инф.Модуля

Исходник

Система

Главная функция этого модуля – достичь синхронизации с ОС (Оперативной Системой)

Синхронизация достигается за счет команд PollSystem и WaitSystem. Однако вам не нужно вызывать эти команды самостоятельно, так как некоторые команды вызывают их за вас.

Так же системный модуль позволяет узнать время и дату, переместить курсор мыши и генерировать простые системные запросчики.

Функции

Функция Confirm( text$,serious=False )
Возвращает	Правду (True) or Ложь (False) зависит от выбора пользователя.
Описание	Запрашивает подтверждение пользователя.
Информация	Функция Confirm активирует простой пользовательский интерфейс с возможностью выбрать: Да или Нет. Если выбор пользователя пал на Да, то функция возвратит Истину (True) . Иначе функция возвратит Ложь. (False) Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.
Пример	' confirm.bmx result=Confirm("Are you sure?") print result

Функция CurrentDate$()
Возвращает	Текущую дату в виде строки.
Описание	Узнает текущую дату.
Информация	Возвращает текущую дату в формате: ДД ММ ГГГГ (например 10 ДЕК 2000).
Пример	' currentdate.bmx Print "The date is "+CurrentDate$()

Функция CurrentTime$()
Возвращает	Текущее время в виде строки.
Описание	Узнает текущее время.
Информация	Возвращает текущее время в формате: ЧЧ:ММ:СС (например 14:31:57).
Пример	' currenttime.bmx Print "The time is "+CurrentTime$()

Функция HideMouse()
Описание	Делает указатель мыши невидимым.

Функция MoveMouse( x,y )
Описание	Передвигает указатель мыши.
Информация	MoveMouse устанавливает курсор в определенные координаты внутри экрана или окна.

Функция Notify( text$,serious=False )
Описание	Уведомляет пользователя.
Информация	Функция Notify активирует простой пользовательский интерфейс, оповещающий пользователя о каком то событии. Дополнительный параметр serious, может служить для обозначения 'критического' события. Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.
Пример	' notify.bmx Notify "Hello World"

Функция OpenURL( url$ )
Описание	Открывает заданный URL, браузером по умолчанию.
Информация	Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.

Функция PollSystem()
Описание	Опрашивает ОС.
Информация	PollSystem возвращает управление ОС, разрешая такие действия, как нажатие клавиш, действия с гаджетами и т.п. Потом управление будет отдано вашей программе. Если PollSystem перехватывает нажатие клавиши, мыши, или ожидание/продолжение/закрытия приложения, то будет сгенерировано событие, с которым вы можете работать, используя обработчик.

Функция Proceed( text$,serious=False )
Возвращает	1, 0 или -1, зависит от выбора пользователя.
Описание	Запрашивает пользовательское подтверждение или отмену.
Информация	Функция Proceed активизирует простой пользовательский интерфейс, который дает пользователю выбрать Да, Нет или Отмена. Если пользователь выберет Да, то функция возвратит 1, если же Нет, то функция вернет 0, а если Отмена, то -1. Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.
Пример	' proceed.bmx result=Proceed("Are you sure you want to continue?") print result

Функция RequestDir$( text$,initial_path$="" )
Возвращает	Путь выбранной папки или пустую строку, если операция была прекращена.
Описание	Отображает системный запросчик путей.
Информация	Параметр text используется в качестве заголовка. Параметр initial_path отвечает, за начальную директорию. Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.
Пример	' requestdir.bmx path$=RequestDir("Select a Folder",CurrentDir()) Print "directory selected was "+path

Функция RequestFile$( text$,extensions$="",save_flag=False,initial_path$="" )
Возвращает	Путь выбранного файла или пустую строку, если операция была прекращена.
Описание	Отображает системный запросчик файлов.
Информация	Параметр text используется в качестве заголовка. Дополнительный строковой параметр extensions может быть разделителем между форматом и названием файла. Параметр save_flag отвечает, будет ли запросчик в стиле Сохранения, стиль по умолчанию – Загрузка. Параметр initial_path отвечает за начальную директорию. Заметьте, что пользовательский интерфейс может быть недоступен при определенном графическом режиме или на какой нибудь платформе.
Пример	' requestfile.bmx filter$="Image Files:png,jpg,bmp;Text Files:txt;All Files:*" filename$=RequestFile( "Select graphic file to open",filter$ ) Print filename

Функция ShowMouse()
Описание	Делает курсор мыши выидимым.

Функция WaitSystem()
Описание	Ждет Оперативную Систему.
Информация	WaitSystem возвращает контроль оперативной системе, ожидая пока не произойдут действия. Запомните, что WaitSystem может ждать бесконечно долго, в том случае если не происходят никакие действия, так что используйте с осторожностью. Если WaitSystem перехватывает нажатие клавиши, мыши, или ожидание/продолжение/закрытия приложения, то будет сгенерировано событие, с которым вы можете работать, используя обработчик

Module Information

Version	1.25
Author	Mark Sibly, Simon Armstrong
License	Blitz Shared Source Code
Copyright	Blitz Research Ltd
Modserver	BRL
History	1.25 Release
History	Fixed unretained object issue with mouse tracking
History	1.24 Release
History	Fixed windowed mode HideMouse issue
History	1.23 Release
History	Fixed win32 requestfile default extension bug#2
History	1.22 Release
History	Fixed win32 requestfile default extension bug
History	1.21 Release
History	New Linux implementation of OpenURL
History	1.20 Release
History	RequestFile now adds extension to filename on Windows
History	1.19 Release
History	Added EVENT_GADGETLOSTFOCUS handling
History	1.18 Release
History	Added EVENT_KEYREPEAT handling
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