iTextProvider：：GetVisibleRanges 方法 (uiautomationcore.h)

项目
08/26/2023

从基于文本的控件中检索不连续文本范围的数组，其中每个文本范围表示可见文本的连续范围。

语法

HRESULT GetVisibleRanges(
  [out, retval] SAFEARRAY **pRetVal
);

参数

[out, retval] pRetVal

类型： SAFEARRAY**

接收指向可见文本范围或空数组的 ITextRangeProvider 接口的指针数组的地址。永远不会返回 NULL 引用。此参数未经初始化即被传递。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

注解

如果可见文本由一个连续的文本范围组成， 则 pRetVal 数组应包含表示所有可见文本的单个文本范围。

如果可见文本由多个不连续的文本范围组成， 则 pRetVal 数组应为每个可见范围包含一个文本范围，从第一个可见范围开始，以最后一个可见范围结束。当基于文本的控件的内容被重叠的窗口或其他对象部分遮盖时，或者具有多个页面或列的基于文本的控件的内容部分滚动到视图之外时，可能会发生不连续的可见文本跨度。

ITextProvider：：GetVisibleRanges 应返回一个退化 (空) 文本范围，如果所有文本都滚动到视图外，或者基于文本的控件不包含任何文本。

要求


最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	uiautomationcore.h (包括 UIAutomation.h)