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
标头 uiautomationcore.h (包括 UIAutomation.h)

请参阅

概念性

ITextProvider

ITextRangeProvider

引用

UI 自动化提供程序概述