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

Продолжение описания встроенных функций языка сценариев JAWS для работы с COM и MSAA.

• Функция GetObjectType
• Функция GetObjectTypeCode
• Функция GetObjectValue
• Функция GetRichEditDocument
• Функция getRoleText
• Функция IE4GetCurrentDocument
• Функция IsMSAAWindow
• Функция JavaObjectChanged
• Функция MSAAGetDialogStaticText
• Функция MSOGetMenuBarObject
• Функция NameChangedEvent
• Функция ObjStateChangedEvent
• Функция SayFocusedObject
• Функция SayObjectActiveItem
• Функция SayObjectTypeAndText
• Функция ValueChangedEvent

Функция GetObjectType

Описание: Возвращает тип объекта, расположенного в позиции активного курсора. Поскольку тип объекта является строкой, которая зависит от языковых настроек, то эта функция может быть использована исключительно для озвучивания типа объекта. Функция GetObjectTypeCode должна использоваться в условных операторах (IF...THEN...), чтобы обеспечить переносимость скриптов и их независимость от языковых настроек.

Возвращаемое значение: String, тип объекта, расположенного в позиции активного курсора.

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

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

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

Функция GetObjectTypeCode

Описание: Возвращает числовой код, обозначающий тип объекта, расположенного в позиции активного курсора. Имена констант, сопоставленных этим кодам, начинаются с префикса WT_ и определены в файле HJCONST.JSH. Числовые коды типов объектов являются независимыми от текущих языковых настроек, поэтому данную функцию следует использовать вместо функции GetObjectType в условных операторах, чтобы обеспечить переносимость скриптов и их независимость от языковых настроек.

Возвращаемое значение: Int, тип объекта, расположенного в позиции активного курсора.

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

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

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

Функция GetObjectValue

Описание: Если активен PC-курсор, то возвращается значение объекта, обладающего фокусом ввода. В противном случае возвращается значение объекта, расположенного в позиции активного курсора. Значение, которое содержит объект, возвращается в виде строки.

Возвращаемое значение: String, значение, которое содержит объект, находящийся в позиции активного курсора.

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

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

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

Функция GetRichEditDocument

Описание: Возвращает указатель на интерфейс ITextDocument документа в указанном окне. Функция работает только с окнами класса RichEdit20A или RichEdit20W. Интерфейс ITextDocument позволяет получить доступ к объектной модели документа RichEdit подобно объектной модели MSWord. Дополнительные сведения можно получить, поискав в Microsoft Developer Network слова "Text Object Model.".

Возвращаемое значение: Object, указатель на интерфейс ITextDocument.

Параметр 1:

Handle, дескриптор интересующего окна. По умолчанию предполагается окно, содержащее фокус ввода. Этот параметр не является обязательным.

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

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

Функция getRoleText

Описание: Эта функция возвращает описание роли объекта. Роль может быть получена через доступ к свойству accRole объекта MSAA. Эта функция эквивалентна функции GetRoleText, входящей в состав MSAA и документированной в MSAA SDK.

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

Параметр 1:

String, константа, обозначающая роль объекта. Эта константа должна быть получена из свойства accRole объекта MSAA. Этот параметр является обязательным.

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

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

Функция IE4GetCurrentDocument

Описание: Эта функция возвращает объект, соответствующий DOM в текущем окне. Объектная модель документа (Document Object Model - DOM) может быть использована для получения информации о документе, доступа к элементам html, изменения их и обработки событий.

Возвращаемое значение: Object, объект, соответствующий текущему html-документу в окне браузера.

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

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

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

Функция IsMSAAWindow

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

Возвращаемое значение: Int, TRUE- если используется MSAA, FALSE - в противном случае.

Параметр 1:

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

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

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

Функция JavaObjectChanged

Описание: Поскольку когда-то компоненты Java UI не предоставляли информацию, чтобы облегчить создание сценариев, подобно другим GUI, то эта функция была специально создана для того, чтобы отслеживать изменения в объектах, в которые нельзя поместить фокус ввода, и передавать информацию о таких изменениях пользователю.

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

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

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

Функция MSAAGetDialogStaticText

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

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

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

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

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

Функция MSOGetMenuBarObject

Описание: Возвращает объект меню (Menu bar object) в приложениях пакета MS Office 97/2000.

Возвращаемое значение: Object, объект меню (Menu bar) текущего приложения Office.

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

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

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

Функция NameChangedEvent

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

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

Параметр 1:

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

Параметр 2:

Int, предопределённый ID объекта. Этот параметр является обязательным.

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

Параметр 6:

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

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

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

Функция ObjStateChangedEvent

Описание: Событийная функция срабатывает при изменении состояния объекта. По умолчанию эта функция теперь сообщает checked или unchecked (отмечен или не отмечен), характеризуя тем самым изменение состояния объекта. При этом разработчики больше не уверены в работе функции KeyPressedEvent.

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

Параметр 1:

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

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

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

Функция SayFocusedObject

Описание: Вызывается функцией FocusChangedEvent, когда фокус перемещается с одного объекта на другой в пределах одного окна. Это работает, если разрешена поддержка MSAA (Microsoft Active Accessibility).

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

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

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

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

Функция SayObjectActiveItem

Описание: Называет активный элемент в каком-либо элементе управления или диалоге. Например, в элементе управления ListView функция сообщит выбранный (подсвеченный) элемент списка; в меню эта функция назовёт активный пункт; в диалоге будет назван текущий элемент.

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

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

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

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

Функция SayObjectTypeAndText

Описание: Сообщает наименование и тип объекта, расположенного в позиции активного курсора. Эта функция похожа на функцию SayWindowTypeAndText за исключением того, что действие этой функции более конкретно. Если указанное окно содержит множество объектов, то эта функция сообщит информацию о том из них, который расположен в позиции курсора, тогда как SayWindowTypeAndText сообщит информацию об окне включительно. Если окно не содержит множества объектов, то действия обеих функций идентичны. Если используется эта функция, то она помечает читаемый текст так, чтобы функции SayHighlightedText и SayNonHighlightedTextне повторяли ту же самую информацию, когда они вызваны.

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

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

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

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

Функция ValueChangedEvent

Описание: Событийная функция срабатывает при изменении значения объекта. Чтобы разрешить работу этой функции, Параметр MSAA должен быть установлен (включен) в вашем файле настроек jcf для конкретного приложения. Эта функция получает следующие параметры: дескриптор окна, содержащего текущий объект MSAA, ID объекта MSAA, ID дочернего элемента, тип объекта, имя объекта и текущее значение объекта.

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

Параметр 1:

Handle, дескриптор окна, содержащего текущий объект MSAA. Этот параметр является обязательным.

Параметр 2:

Int, ID объекта. Этот параметр является обязательным.

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

Параметр 6:

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

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

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