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

• Функция DialogActive
• Функция DialogList
• Функция DialogListHelper
• Функция DialogPageChangedEvent
• Функция GetDefaultButtonName
• Функция GetDialogPageName
• Функция GetDialogStaticText
• Функция GetGroupBoxName
• Функция IsMultiPageDialog
• Скрипт NextDocumentWindow
• Скрипт PreviousDocumentWindow
• Скрипт ReadBoxInTabOrder
• Скрипт SayDefaultButton

Функция DialogActive

Описание: Используется для определения, является ли текущее (активное) окно диалоговым окном (dialogbox). Возвращает одну из констант, характеризующую это состояние:

• ACTIVE - если окно диалога активно;
• INACTIVE - если окно диалога не является активным.

Эти константы могут быть использованы в конструкции If...Then...EndIf.

Возвращаемое значение: Int. "ACTIVE" = 1, "INACTIVE" = 0.

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

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

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

Функция DialogList

Описание: Эта функция, будучи вызвана в активном окне диалога, выводит список всех элементов управления текущего диалога. В этом списке можно выбрать нужный элемент управления и нажать клавишу Enter, чтобы переместить фокус ввода в окне диалога на выбранный элемент. Комбинация клавиш ALT + L, нажатая в списке элементов управления, выполняет щелчок левой кнопки мыши по выбранному элементу. Замечание: эта функция корректно работает только со стандартными диалоговыми окнами Windows. В случае нестандартных диалоговых окон информация, отображаемая в списке, может быть неполной.

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

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

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

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

Пример

Следующий скрипт выводит список элементов диалога в том случае, если окно диалога является активным. Создайте этот скрипт в файле скриптов для текстового редактора Блокнот (Notepad), назначьте скрипту комбинацию клавиш. Загрузите программу Блокнот (Notepad), теперь следует выбрать пункт меню Файл/Открыть. Появится диалог открытия файла. Вызовите скрипт при помощи назначенной комбинации клавиш. На экране появится диалог со списком элементов управления из диалога открытия файлов. В списке будут названия элементов управления и их тип (например, Папка ComboBox, Имя файла Edit, Тип файла ComboEdit и т.п.).

Script ShowDialogItems ()
If DialogActive () Then
DialogList ()
EndIf
EndScript

Функция DialogListHelper

Описание: отсутствует

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

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

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

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

Функция DialogPageChangedEvent

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

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

Параметр 1:

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

Параметр 2:

Handle, Дескриптор окна, содержащего страницу диалога, которая была активна в предыдущий момент (т.е. которая только что потеряла фокус ввода).

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

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

Функция GetDefaultButtonName

Описание: Определяет кнопку по умолчанию в активном окне диалога. Кнопка по умолчанию - это кнопка в окне диалога, которая будет нажата в том случае, если пользователь нажмёт клавишу Enter. Как правило, такой кнопкой является кнопка ОК.

Возвращаемое значение: String. Наименование кнопки по умолчанию.

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

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

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

Функция GetDialogPageName

Описание: Если активный курсор расположен в окне диалога, имеющем много страниц (вкладок), то эта функция возвращает имя текущей страницы (вкладки).

Возвращаемое значение: String. Имя текущей страницы в диалоговом окне.

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

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

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

Функция GetDialogStaticText

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

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

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

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

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

Функция GetGroupBoxName

Описание: Возвращает наименование текущей группы элементов управления в диалоговом окне.Примером группы может служить объединение опций выбора (checkbox) зачёркнутый, подчёркнутый и комбинированного списка (combobox) цвет, названное общим именем "Видоизменение" в диалоге выбора шрифта в редакторе WordPad. В этом примере "Видоизменение" и является наименованием группы.

Возвращаемое значение: String. Наименование группы.

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

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

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

Функция IsMultiPageDialog

Описание: Проверяет, находится ли активный курсор внутри многостраничного диалога (диалога с двумя и более вкладками).

Возвращаемое значение: Int. TRUE - если диалог является многостраничным, FALSE - если не является.

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

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

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

Скрипт NextDocumentWindow

Описание: Используется для переключения между окнами документов в многодокументном приложении, между окнами в одной группе окон, а также между страницами (вкладками) в многостраничном диалоге. Как правило, этот скрипт связан с комбинацией клавиш Control + Tab.

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

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

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

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

Скрипт PreviousDocumentWindow

Описание: Используется для переключения в обратном порядке между окнами документов в многодокументном приложении, между окнами в одной группе окон, а также между страницами (вкладками) в многостраничном диалоге. Как правило, этот скрипт связан с комбинацией клавиш Shift + Control + Tab.

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

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

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

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

Скрипт ReadBoxInTabOrder

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

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

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

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

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

Скрипт SayDefaultButton

Описание: Называет кнопку диалога по умолчанию. Как правило, диалоговое окно имеет кнопку, срабатывающую, если пользователь нажимает клавишу Enter, даже, если фокус ввода не установлен на этой кнопке. Такая кнопка и называется кнопкой по умолчанию. Например, во многих сообщениях такой кнопкой является ОК. В настройках Jaws по умолчанию этому скрипту назначена комбинация клавиш JAWSKey + E. Если активный курсор находится вне диалогового окна, то скрипт сообщает об этом.

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

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

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

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