IUIAutomationTextPattern：：GetVisibleRanges 方法 (uiautomationclient.h)

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

语法

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

[out, retval] ranges

接收指向基于文本的控件中可见文本范围的集合的指针。

类型： HRESULT

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

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

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

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

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	uiautomationclient.h (包括 UIAutomation.h)