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

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

• Скрипт SayTaskBar
• Функция ScreenGetHeight
• Функция ScreenGetWidth
• Функция SetRegistryEntryDWORD
• Функция SetRegistryEntryString
• Функция SetSystemVolume
• Скрипт StartJAWSTaskList
• Функция SwitchToPreviousApp
• Функция SysGetDate
• Функция SysGetTime
• Функция SysTrayGetItemCount
• Функция SysTrayGetItemToolType
• Функция SysTrayMoveToItem
• Функция UseAlternateLanguage
• Скрипт ViewSysTrayItems

Скрипт SayTaskBar

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

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

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

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

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

Функция ScreenGetHeight

Описание: Функция возвращает высоту экрана в пикселах.

Возвращаемое значение: Int, высота экрана в пикселах.

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

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

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

Функция ScreenGetWidth

Описание: Функция возвращает ширину экрана в пикселах.

Возвращаемое значение: Int, ширина экрана в пикселах.

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

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

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

Функция SetRegistryEntryDWORD

Описание: Функция позволяет записать значение параметра типа DWORD в системном реестре.Если в реестре заданный параметр отсутствует, то он будет создан. Следует быть внимательным при работе с системным реестром, так как изменение или потеря важных данных из реестра может привести к аварийному сбою приложений или системы в целом.

Возвращаемое значение: int, если запись параметра прошла успешно, то возвращается 1; в противном случае возвращается 0.

Параметр 1:

int, номер раздела системного реестра:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

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

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

Функция SetRegistryEntryString

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

Возвращаемое значение: int, если запись параметра прошла успешно, то возвращается 1; в противном случае возвращается 0.

Параметр 1:

int, номер раздела системного реестра:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

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

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

Функция SetSystemVolume

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

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

Параметр 1:

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

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

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

Скрипт StartJAWSTaskList

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

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

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

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

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

Функция SwitchToPreviousApp

Описание: Эта функция имитирует нажатие и удержание клавиши ALT и последующее нажатие и отпускание клавиши TAB нужное число раз.

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

Параметр 1:

int, количество нажатий клавиши Tab при удержании клавиши Alt. По умолчанию предполагается значение 1, что соответствует однократному нажатию комбинации Alt+Tab. Этот параметр не является обязательным.

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

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

Функция SysGetDate

Описание: Возвращает строку, которая содержит заданную дату в определённом формате.

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

Параметр 1:

String, формат представления даты, например, "dd/MM/yyyy". Этот параметр не является обязательным.

Параметр 2:

Int, значение месяца (число от 1 до 12). Этот параметр не является обязательным.

Параметр 3:

Int, число месяца (значение от 1 до числа дней в выбранном месяце). Этот параметр не является обязательным.

Параметр 4:

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

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

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

Функция SysGetTime

Описание: Функция возвращает строку, представляющую заданное время в определённом формате.

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

Параметр 1:

String, формат, в котором необходимо представить время. Например: "hh:mm tt". Этот параметр не является обязательным.

Параметр 2:

Int, значение часов (от 0 до 23). Этот параметр не является обязательным.

Параметр 3:

Int, значение минут (от 0 до 59). Этот параметр не является обязательным.

Параметр 4:

Int, значение секунд (от 0 до 59). Этот параметр не является обязательным.

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

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

Функция SysTrayGetItemCount

Описание: Возвращает число элементов в системном трее.

Возвращаемое значение: Int, число элементов.

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

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

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

Функция SysTrayGetItemToolType

Описание: Используется в ListTaskTrayIcons, чтобы получить текст всплывающей подсказки, связанной с определённой иконкой в системном трее. Эта функция в качестве единственного параметра получает номер элемента в системном трее и возвращает строку с текстом всплывающей подсказки для данного элемента.

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

Параметр 1:

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

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

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

Функция SysTrayMoveToItem

Описание: Функция перемещает Jaws-курсор на указанный элемент в системном трее.

Возвращаемое значение: Int, TRUE, если перемещение было успешным.

Параметр 1:

Int, номер интересующего элемента в системном трее. Этот параметр является обязательным.

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

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

Функция UseAlternateLanguage

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

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

Параметр 1:

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

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

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

Скрипт ViewSysTrayItems

Описание: Этот скрипт отображает в окне виртуального просмотра список элементов, находящихся в системном трее и тексты всплывающих подсказок для них. Эта информация при необходимости может быть скопирована из окна виртуального просмотра. Как правило, этот скрипт вызывается комбинацией клавиш Control+Shift+f11.

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

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

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

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