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) |