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