Share via

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)

另請參閱

ITextProvider2