IUIAutomationTextPattern::GetSelection 方法 (uiautomationclient.h)

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

语法

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

参数

[out, retval] ranges

类型: IUIAutomationTextRangeArray**

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

返回值

类型: 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)

另请参阅

IUIAutomationTextPattern

对文本内容的UI 自动化支持