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

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

• Функция InvalidateRect
• Функция IsDescendedFromWindow
• Функция IsPegHelpWindow
• Функция IsPointInWindow
• Функция IsSelectedRadioButton
• Функция isSystemDialog
• Функция IsWindowDisabled
• Функция IsWindowObscured
• Функция IsWindowVisible
• Функция lvGetItemColumnRect
• Функция lvGetNumOfColumns
• Функция lvIsReportListStyle
• Функция MoveToWindow
• Функция navGetAppMainObjectID
• Функция navGetCurrentObjectID
• Функция navGetFirstChildObjectID
• Функция navGetFirstObjectID
• Функция navGetFocusObjectID
• Функция navGetLastObjectID

Функция InvalidateRect

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

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

Int, ненулевое значение, если функция выполнилась успешно, и 0, если возникла ошибка.

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

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

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

Функция IsDescendedFromWindow

Описание: Проверяет, имеют ли два указанных окна родительско-дочерние отношения

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

Параметр 1:

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

Параметр 2:

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

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

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

Функция IsPegHelpWindow

Описание: Определяет, находится ли фокус в главном окне помощи.

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

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

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

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

Функция IsPoIntInWindow

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

Возвращаемое значение: Int, если точка лежит внутри ограничивающего прямоугольника, то возвращается 1, если нет - возвращается 0.

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

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

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

Функция IsSelectedRadioButton

Описание: Проверяет, если указанное окно является радиокнопкой, выбрана она или нет.

Возвращаемое значение: Int, True, если радиокнопка установлена (выбрана), FALSE - в противном случае.

Параметр 1:

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

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

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

Функция isSystemDialog

Описание: Проверяет, находится ли фокус ввода в системном диалоге.

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

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

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

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

Функция IsWindowDisabled

Описание: Проверяет состояние текущего окна или элемента управления. Функция возвращает FALSE, если окно активно, и TRUE, если окно заблокировано (недоступно).

Возвращаемое значение: Int, TRUE, если окно заблокировано (недоступно), FALSE -- в противном случае.

Параметр 1:

Handle, дескриптор окна, которое нужно проверить. В качестве параметра можно передать значения, возвращённые функциями GetFocus или GetCurrentWindow. Этот параметр является обязательным.

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

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

Функция IsWindowObscured

Описание: Проверяет, не перекрыто ли окно каким-то другим окном, и поэтому оно не может быть видимо целиком.

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

Параметр 1:

Handle, дескриптор окна, которое следует проверить. В качестве параметра может быть передано значение, возвращённое функциями GetFocus или GetCurrentWindow. Этот параметр является обязательным.

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

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

Функция IsWindowVisible

Описание: Проверяет состояние видимости указанного окна (в Windows при создании окна можно указать видимо оно или нет). Эта функция возвращает TRUE, когда окно присутствует на экране, даже если указанное окно полностью закрыто другими окнами. Чтобы узнать, перекрыто ли указанное окно другими окнами, нужно использовать функцию IsWindowObscured.

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

Параметр 1:

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

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

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

Функция lvGetItemColumnRect

Описание: Возвращает ограничивающий прямоугольник вокруг элемента в указанном столбце listview или listcontrol.

Возвращаемое значение: Int, TRUE, если координаты ограничивающего прямоугольника были успешно определены и переданы.

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

Параметр 6:

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

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

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

Функция lvGetNumOfColumns

Описание: Возвращает число столбцов в органе управления список (List) или listview.

Возвращаемое значение: Int, число столбцов в органе управления список (List) или ListView.

Параметр 1:

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

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

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

Функция lvIsReportListStyle

Описание: Определяет стиль элемента управления ListBox или ListView.

Возвращаемое значение: Int, TRUE, если удалось определить стиль элемента управления ListBox или ListView.

Параметр 1:

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

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

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

Функция MoveToWindow

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

Возвращаемое значение: Int, "WAS_SUCCESSFUL" = 1 (окно было найдено), "WAS_NOT_SUCCESSFUL" = 0 (окно не было найдено).

Параметр 1:

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

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

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

Функция navGetAppMainObjectID

Описание: Определяет ID (идентификатор) главного объекта активного приложения.

Возвращаемое значение: Handle, предоставляет ID главного объекта приложения.

Параметр 1:

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

Параметр 2:

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

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

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

Функция navGetCurrentObjectID

Описание: Возвращает ID объекта, расположенного в позиции активного курсора. ID объекта используется некоторыми функциями, возвращающими информацию об объекте.

Возвращаемое значение: Handle, ID объекта или 0, если ID объекта не может быть получен.

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

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

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

Функция navGetFirstChildObjectID

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

Возвращаемое значение: Handle, ID первого дочернего объекта или 0, если такой объект не найден.

Параметр 1:

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

Параметр 2:

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

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

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

Функция navGetFirstObjectID

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

Возвращаемое значение: Int, ID объекта.

Параметр 1:

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

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

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

Функция navGetFocusObjectID

Описание: Возвращает ID (идентификатор) объекта, в котором находится фокус ввода. ID объекта используется некоторыми функциями, возвращающими информацию об объекте.

Возвращаемое значение: Handle, ID объекта, содержащего фокус ввода, или 0, если ID объекта определить не удалось.

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

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

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

Функция navGetLastObjectID

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

Возвращаемое значение: Int, ID объекта.

Параметр 1:

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

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

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