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) |
另請參閱
概念
參考