Работа с окнами (6)

(По материалам Freedom Scientific Developer Network)
Дата публикации:2005
Twitter Facebook Vkontakte

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

Скрипт SaySpecialWindowClasses

Описание: Скрипт циклически озвучивает 4 группы окон: родительские окна, дочерние окна, предыдущее окно того же уровня и следующее окно того же уровня. Для того чтобы узнать название классов соответствующих окон, необходимо последовательно нажимать комбинацию клавиш CTRL+INSERT+F2. Более подробную информацию об окнах можно получить, используя функции утилит homerow.

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

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

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

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

Функция SayToBottom

Описание: Функция читает текст в текущем окне от позиции активного курсора и до нижней границы окна. Во время чтения текста курсор не перемещается и прокрутка (скроллинг ) окна не выполняется.

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

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

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

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

Скрипт SayTopLineOfWindow

Описание: Этот скрипт читает самую верхнюю строку текста в окне. Обычно этой строкой является заголовок окна.

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

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

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

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

Функция SayWindow

Описание: Функция читает текст в указанном окне. Возможно чтение либо только подсвеченного текста, либо всего текста, содержащегося в окне.

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

Параметр 1:

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

Параметр 2:

Int, одна из констант, определённых в файле HJConst.JSH. Эта константа указывает, какой текст будет озвучен:

  • READ_EVERYTHING = 0 ; озвучивать весь текст
  • READ_HIGHliGHTED = 1; озвучивать подсвеченный текст

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

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

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

Скрипт SayWindowPromptAndText

Описание: Скрипт сообщает тип окна и подсказку для этого окна или элемента управления, в которых расположен фокус ввода. Если активен виртуальный курсор на web-странице, то при первом вызове этого скрипта для текущего элемента управления JAWS сообщает информацию об этом элементе, используя текущие установки "многословия". При последующих нажатиях комбинации клавиш, вызывающей этот скрипт, JAWS, возможно, озвучит этот элемент управления другим голосом (в соответствии с голосовыми настройками для сообщений). Как правило, этот скрипт выполняется по комбинации клавиш Insert + Tab.

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

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

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

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

Скрипт SayWindowTitle

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

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

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

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

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

Функция SayWindowTypeAndText

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

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

Параметр 1:

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

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

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

Функция SendMessage

Описание: Эта функция предоставляет ограниченный доступ к функции SendMessage из Windows API (более подробную информацию по функциям Windows API следует искать в the Windows Platform SDK и других руководствах по программированию в среде Windows). Для параметров wParam и lParam допускаются только числовые значения. Указатели на строки или структуры для этих параметров не поддерживаются. Возвращаемое значение тоже интерпретируется как целое.

Возвращаемое значение: Int, результат вызова системной функции SendMessage.

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

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

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

Функция SetFocus

Описание: Перемещает фокус ввода в указанное окно.

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

Параметр 1:

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

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

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

Функция SetFocusToFirstFocusableControl

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

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

Параметр 1:

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

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

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

Функция SetForegroundWindow

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

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

Параметр 1:

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

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

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

Функция SetParentDims

Описание: Эта функция присваивает глобальным переменным GlobalFrameParentLeft, GlobalFrameParentTop, GlobalFrameParentRight и GlobalFrameParentBottom значения, соответствующие координатам левого верхнего и правого нижнего углов окна активного приложения. Указанные глобальные переменные используются Диспетчером фреймов (Frame Viewer).

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

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

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

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

Функция ToolTipEvent

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

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

Параметр 1:

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

Параметр 2:

string, в этом параметре функция получает текст подсказки. Этот параметр является обязательным.

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

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

Скрипт VirtualizeWindow

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

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

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

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

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

Функция WindowActivatedEvent

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

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

Параметр 1:

handle, в этом параметре функция получает дескриптор окна, которое стало активным. Этот параметр является обязательным.

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

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

Скрипт WindowClassReassign

Описание: Этот скрипт вызывает диалог переназначения классов окон (Window Class Reassign), в котором можно переназначить клас текущего окна на один из стандартных классов. Такое переназначение нередко улучшает работу JAWS с этим классом окон.

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

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

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

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

Функция WindowCreatedEvent

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

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

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

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

Функция WindowDestroyedEvent

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

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

Параметр 1:

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

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

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

Функция WindowMinMaxEvent

Описание: Событийная функция срабатывает всякий раз, когда меняется статус окна (окно сворачивается, разворачивается или восстанавливается). Второй параметр этой функции (nMinMaxRest) содержит общую информацию о том, что произошло с окном, в виде констант: WE_MINIMIZE, WE_MAXIMIZE или WE_RESTORE. Третий параметр (nShow) содержит уточняющую информацию в виде соответствующих констант из файла hjconst.jsh, которые начинаются префиксом "SW_".

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

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

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

Функция WindowResizedEvent

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

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

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

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

Функция WmGetText

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

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

Параметр 1:

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

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

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


Распространение материалов сайта означает, что распространитель принял условия лицензионного соглашения.
Идея и реализация: © Владимир Довыденков и Анатолий Камынин,  2004-2019