IUIAutomationTextPattern::GetVisibleRanges 方法 (uiautomationclient.h)
從文字型控件擷取不連續文字範圍的陣列,其中每個文字範圍都代表連續的可見文字範圍。
語法
HRESULT GetVisibleRanges(
[out, retval] IUIAutomationTextRangeArray **ranges
);
參數
[out, retval] ranges
類型: IUIAutomationTextRangeArray**
接收文字型控件內可見文字範圍的集合指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果可見文字是由一個連續的文字範圍所組成, 則範圍 數位會包含代表所有可見文字的單一文字範圍。
如果可見文字包含多個不相鄰的文字範圍, 範圍 陣列會針對每個可見範圍包含一個文字範圍,從第一個可見範圍開始,並以最後一個可見範圍結束。 當文字型控件的內容部分被重疊的視窗或其他物件遮蔽時,或是當具有多個頁面或欄的文字型控件具有部分卷動出檢視的內容時,就會發生不相鄰的文字範圍。
IUIAutomationTextPattern::GetVisibleRanges 會擷取空的 (空的) 文字範圍,如果沒有顯示任何文字,則為,如果所有文字都從檢視中卷動,或是文字型控件不包含任何文字,則為 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7、Windows Vista sp2 和 Platform Update for Windows Vista、Windows XP with SP3 和 Platform Update for Windows Vista [僅限桌面應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | uiautomationclient.h (包含 UIAutomation.h) |