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