ITextProvider：：GetVisibleRanges 方法 (uiautomationcore.h)

發行項
08/26/2023

從以文字為基礎的控制項擷取不相鄰文字範圍的陣列，其中每個文字範圍都代表連續的可見文字範圍。

語法

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

參數

[out, retval] pRetVal

類型： SAFEARRAY**

接收可見文字範圍或空陣列之 ITextRangeProvider 介面之指標陣列的位址。永遠不會傳回 Null 參考。這個參數會以未初始化的狀態傳遞。

傳回值

類型： HRESULT

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

備註

如果可見文字是由一個連續文字範圍所組成， pRetVal 陣列應該包含代表所有可見文字的單一文字範圍。

如果可見文字是由多個不連續的文字範圍所組成， 則 pRetVal 陣列應該針對每個可見範圍包含一個文字範圍，從第一個可見範圍開始，並以最後一個可見範圍結束。當以文字為基礎的控制項內容部分被重迭的視窗或其他物件遮蔽時，或是當具有多個頁面或欄的文字控制項有部分捲動離開檢視的內容時，就會發生不連續的文字範圍。

如果看不到任何文字，則 ITextProvider：：GetVisibleRanges應該會傳回空的) 文字範圍、如果所有文字都捲動到檢視之外，或是以文字為基礎的控制項不包含任何文字，則傳 (回空的) 文字範圍。

需求


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