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

Статья
08/26/2023

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

Синтаксис

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)