IUIAutomationTextPattern：：GetSelection 方法 (uiautomationclient.h)

检索表示基于文本的控件中当前选定文本的文本范围的集合。

语法

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

[out, retval] ranges

接收指向文本范围集合的指针。

类型： HRESULT

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

如果控件支持选择多个非连续文本范围，则 ranges 集合将为每个所选范围接收一个文本范围。

如果控件仅包含所选文本的单个范围，则 ranges 集合将接收单个文本范围。

如果控件包含文本插入点，但未选择任何文本，则 ranges 集合在文本插入点的位置接收一个退化 (空) 文本范围。

如果控件不包含文本插入点或不支持文本选择， 则范围 设置为 NULL。

使用 IUIAutomationTextPattern：：SupportedTextSelection 属性测试控件是否支持文本选择。

要求	值
最低受支持的客户端	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)