Поделиться через

Метод ITextProvider::RangeFromPoint (uiautomationcore.h)

  • Статья

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

Синтаксис

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Параметры

[in] point

Тип: UiaPoint

Местоположение в экранных координатах.

[out, retval] pRetVal

Тип: ITextRangeProvider**

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

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

Тип: HRESULT

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

Комментарии

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

Так как скрытый текст не игнорируется ITextProvider::RangeFromPoint, возвращается вырожденный диапазон от видимого текста, ближайшего к заданной точке.

Свойство никогда не возвращает значение NULL.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)

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

Основные понятия

ITextProvider

ITextRangeProvider

Справочные материалы

Общие сведения о поставщиках автоматизации пользовательского интерфейса