IUIAutomationTextPattern2::GetCaretRange 方法 (uiautomationclient.h)
检索属于基于文本的控件的插入点位置处的零长度文本范围。
语法
HRESULT GetCaretRange(
[out, retval] BOOL *isActive,
[out, retval] IUIAutomationTextRange **range
);
参数
[out, retval] isActive
类型: BOOL*
如果包含插入符号的基于文本的控件具有键盘焦点,则为 TRUE,否则为 FALSE。
[out, retval] range
类型: IUIAutomationTextRange**
接收一个文本范围,该范围表示属于基于文本的控件的插入点的当前位置。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
如果 isActive 参数为 FALSE,则属于基于文本的控件的插入点可能与系统插入点不在同一位置。
此方法检索一个文本范围,客户端可以使用该范围查找属于基于文本的控件的插入点的边框,或查找插入点附近的文本。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | uiautomationclient.h (包括 UIAutomation.h) |