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