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)

另请参阅

IUIAutomationTextPattern2

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

使用基于文本的控件