Автор:	© Анатолий Камынин
Дата публикации:	2006

Справка по встроенным функциям языка сценариев JAWS, которые взаимодействуют с операционной системой и позволяют получать информацию о системных настройках, типе операционной системы, работать с системным треем и т.п.

• Функция GetInputLanguage
• Функция GetRegistryEntryDWORD
• Функция GetRegistryEntryString
• Функция GetSystemDefaultLang
• Функция GetSystemLocaleInfo
• Функция GetSystemVolume
• Функция GetSystemVolumeRange
• Функция GetTickCount
• Функция GetUserDefaultLang
• Функция GetUserLocaleInfo
• Функция GetWindowsOS
• Функция GetWindowsSystemDirectory
• Функция IsWinNtOr95
• Функция LastBootType
• Скрипт ListTaskTrayIcons
• Функция Run
• Скрипт SayBatteryLevel
• Скрипт SayDriveLetter
• Скрипт SaySystemTime
• Скрипт SaySystemTray

Функция GetInputLanguage

Описание: Функция возвращает название текущего языка текстового ввода. Добавить необходимый язык текстового ввода можно, вызвав Панель управления (Control Panel) и выбрав элемент Язык и региональные стандарты (Regional and Language Options).

Возвращаемое значение: String, название активного языка текстового ввода

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. JAWS 4.51 и более поздних

Функция GetRegistryEntryDWORD

Описание: Функция используется для получения значения параметра типа DWORD из системного реестра.

Возвращаемое значение: int, значение, полученной из реестра. Проверка ошибочных значений не выполняется.

Параметр 1:

int, целое число, соответствующее определённому разделу реестра:

• 0=HKEY_CLASSES_ROOT,
• 1=HKEY_CURRENT_USER,
• 2=HKEY_LOCAL_MACHINE,
• 3=HKEY_USERS.

Параметр 2:

String, название ключа реестра. Этот параметр является обязательным. В названии ключа реестра необходимо удваивать символ обратной наклонной черты (\), для того чтобы не было ошибок.

Параметр 3:

String, название параметра типа DWORD. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 2.0 и более поздних
2. JAWS 5.10 и более поздних

Функция GetRegistryEntryString

Описание: Функция используется для получения значения параметра типа STRING из системного реестра.

Возвращаемое значение: String, значение параметра типа STRING или пустая строка, если такой параметр не существует.

Параметр 1:

int, целое число, соответствующее определённому разделу реестра:

• 0=HKEY_CLASSES_ROOT,
• 1=HKEY_CURRENT_USER,
• 2=HKEY_LOCAL_MACHINE,
• 3=HKEY_USERS.

Параметр 2:

String, название ключа реестра. Этот параметр является обязательным.

Параметр 3:

String, название строкового параметра из системного реестра. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 2.0 и более поздних
2. JAWS 5.10 и более поздних (В некоторых реализациях версии 5.10 функция всегда возвращает пустую строку).

Функция GetSystemDefaultLang

Описание: Функция возвращает трёхбуквенную аббревиатуру языка, установленного по умолчанию в операционной системеWindows.

Возвращаемое значение: String, строка, содержащая трёхбуквенную аббревиатуру, обозначающую язык пользовательского интерфейса, установленный по умолчанию в операционной системе Windows.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция GetSystemLocaleInfo

Описание: Эта функция возвращает информацию о локальных настройках операционной системы, установленных по умолчанию. Файл locale.jsh содержит константы, указывающие, какую информацию необходимо получить при помощи этой функции.

Возвращаемое значение: String, запрошенная информация о локальных настройках.

Параметр 1:

Int, в этом параметре передаётся одна из констант из файла locale.jsh. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних (В версиях 4.51 и 5.00 в файле local.jsh может содержаться ошибка - после определения последней константы стоит лишняя запятая. Эту запятую следует удалить.).

Пример

Скрипт получает информацию, которая хранится в локальных настройках операционной системы (в данном случае это название страны) и сообщает эту информацию.

Include "locale.jsh"
Script SayCountry ()
SayString ("Страна: " + GetSystemLocaleInfo (LOCALE_SCOUNTRY))
EndScript

Функция GetSystemVolume

Описание: Эта функция возвращает целочисленное значение, соответствующее текущей системной громкости звука. Громкость звука можно регулировать при помощи системного микшера.

Возвращаемое значение: Int, текущее значение системной громкости звука.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 5.10 и более поздних

Функция GetSystemVolumeRange

Описание: Эта функция возвращает минимальное и максимальное значение громкости звука в системе.

Возвращаемое значение: Void

Параметр 1:

Int, переменная, в которой функция возвратит минимально возможное значение громкости звука в системе. Этот параметр является обязательным.

Параметр 2:

Int, переменная, в которой функция возвращает максимально возможное значение громкости звука в системе. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 5.10 и более поздних

Функция GetTickCount

Описание: Функция возвращает время, прошедшее с момента запуска операционной системы.

Возвращаемое значение: Int, время в миллисекундах, прошедшее с момента старта операционной системы.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 5.00 и более поздних

Функция GetUserDefaultLang

Описание: Функция возвращает трёхбуквенную аббревиатуру, обозначающую язык пользовательского интерфейса Windows, установленный по умолчанию для текущего пользователя (то есть для пользователя, работающего в текущем сеансе Windows).

Возвращаемое значение: String, трёхбуквенная аббревиатура, соответствующая языку пользовательского интерфейса, установленного в системе по умолчанию для текущего пользователя.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция GetUserLocaleInfo

Описание: Эта функция возвращает информацию о локальных настройках, специфичных для текущего пользователя. Тип возвращаемой информации зависит от того, какое значение будет передано в параметре этой функции. Возможные значения находятся в файле locale.jsh.

Возвращаемое значение: String, запрошенная информация о локальных настройках.

Параметр 1:

Int, одна из констант, определённых в файле locale.jsh. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних (В версиях 4.51 и 5.00 в файле local.jsh может содержаться ошибка - после определения последней константы стоит лишняя запятая. Эту запятую следует удалить.)

Функция GetWindowsOS

Описание: Функция возвращает информацию о текущей операционной системе Windows.

Возвращаемое значение: Int, одна из следующих констант: OS_WIN95 или OS_WIN_NT. Эти константы определены в файле HJCONST.jsh.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция GetWindowsSystemDirectory

Описание: Функция возвращает строку, содержащую путь к системному каталогу Windows (например, "C:\WINDOWS\SYSTEM32").

Возвращаемое значение: String, путь к системному каталогу Windows.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. JAWS 4.51 и более поздних

Функция IsWinNtOr95

Описание: Эта функция возвращает TRUE, если текущей операционной системой является либо Windows 95, либо Windows NT 4.0.

Возвращаемое значение: Тип: Int, true или false.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция LastBootType

Описание: Функция определяет, каким был тип последней загрузки операционной системы ("тёплым" или "холодным").

Возвращаемое значение: Int, TRUE, если произошла "тёплая" перезагрузка операционной системы, и FALSE, если была "холодная" перезагрузка системы.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних

Скрипт ListTaskTrayIcons

Описание: Отображает на экране диалог со списком иконок, находящихся в системном трее. Пользователь может выбрать нужную иконку и выполнить одно из следующих действий: щёлкнуть левой клавишей мыши, щёлкнуть правой клавишей мыши или щёлкнуть дважды левой клавишей мыши. Как правило, этот скрипт вызывается комбинацией клавиш JAWSKey+F11.

Возвращаемое значение: Void

Параметры: отсутствуют

Скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция Run

Описание: Эта функция работает подобно диалогу "Выполнить" ("Run") из меню кнопки "Пуск" ("Start"). Если в качестве параметра этой функции указать имя исполняемого файла какого-нибудь приложения, то будет запущено это приложение. Если в качестве параметра указать каталог, то будет запущен Проводник Windows, который отобразит содержимое этого каталога. Если в качестве параметра указать файл с расширением, отличным от.exe, то, если этому файлу сопоставлено какое-нибудь приложение, то будет запущено это приложение. Например, если в качестве параметра указать строку "readme.txt" и если файл readme.txt существует, то будет запущено приложение "Блокнот" ("Notepad") с файлом readme.txt.

Возвращаемое значение: Void

Параметр 1:

string, командная строка, которую необходимо выполнить. Эта строка, например, может содержать полный путь к файлу (включая его имя и расширение). Следует обратить внимание, что если в строке присутствуют символы обратного слэша (\), то они должны быть удвоены, например: "C:\\WINDOWS\\Notepad.exe", в противном случае возможны фатальные ошибки в работе скрипта. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт SayBatteryLevel

Описание: На портативных компьютерах при использовании аккумулятора на экране присутствует информация о степени разряда аккумулятора. Скрипт сообщает эту информацию. Как правило, скрипт вызывается комбинацией клавиш JAWSKey+Shift+B.

Возвращаемое значение: Void

Параметры: отсутствуют

Скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт SayDriveLetter

Описание: Сообщает имя локального или сетевого диска, на котором находится фокус в Проводнике Windows. Как правило, по умолчанию скрипту не назначена клавиатурная комбинация.

Возвращаемое значение: Void

Параметры: отсутствуют

Скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт SaySystemTime

Описание: Этот скрипт сообщает текущее системное время, а при быстром двойном нажатии комбинации клавиш, связанной с этим скриптом, сообщает текущую системную дату. Как правило, этот скрипт вызывается комбинацией клавиш JAWSKey+F12.

Возвращаемое значение: Void

Параметры: отсутствуют

Скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт SaySystemTray

Описание: Скрипт сообщает содержимое системного трея, включая показания системных часов. Как правило, по умолчанию для этого скрипта нет комбинации клавиш.

Возвращаемое значение: Void

Параметры: отсутствуют

Скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних