Метод IUIAutomationTextPattern::RangeFromPoint (uiautomationclient.h)

  • Статья

Извлекает вырожденный (пустой) текстовый диапазон, ближайший к указанным координатам экрана.

Синтаксис

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Параметры

[in] pt

Тип: POINT

Структура, содержащая расположение в экранных координатах.

[out, retval] range

Тип: IUIAutomationTextRange**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Текстовый диапазон, который заключает дочерний объект, возвращается, если экранные координаты находятся в пределах координат изображения, гиперссылки, электронной таблицы Microsoft Excel или другого внедренного объекта.

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

Реализация RangeFromPoint в Windows Internet Обозреватель 9 не возвращает ожидаемый результат. Вместо этого клиенты должны:

  1. Вызовите метод GetVisibleRanges , чтобы получить массив видимых текстовых диапазонов.
  2. Для каждого текстового диапазона в массиве вызовите метод IUIAutomationTextRange::GetBoundingRectangles , чтобы получить ограничивающие прямоугольники.
  3. Проверьте ограничивающие прямоугольники, чтобы найти диапазон текста, который занимает определенные экранные координаты.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header uiautomationclient.h (включая UIAutomation.h)

См. также раздел

IUIAutomationTextPattern

Модель автоматизации пользовательского интерфейса поддержка текстового содержимого