ITextProvider::GetSelection 方法 (uiautomationcore.h)

擷取文字範圍的集合,代表文字型控制項中目前選取的文字。

語法

HRESULT GetSelection(
  [out, retval] SAFEARRAY **pRetVal
);

參數

[out, retval] pRetVal

類型: SAFEARRAY**

接收文字範圍的 ITextRangeProvider 介面指標陣列位址,每個選取的文字範圍各一個。 這個參數會以未初始化的狀態傳遞。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

對於支援文字選取的 UI 自動化提供者,提供者應該實作此方法,同時傳回 ITextProvider::SupportedTextSelection 值。

如果控制項只包含選取文字的單一範圍, pRetVal 陣列應該包含單一文字範圍。

如果控制項包含文字插入點但未選取任何文字, pRetVal 陣列應該包含空的 (空的) 文字範圍位於文字插入點的位置。

如果控制項未包含選取的文字,或控制項不包含文字插入點,請將 pRetVal 設定為 Null

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

使用安全陣列的最佳做法

概念

ITextProvider

ITextRangeProvider

參考

UI 自動化提供者概觀