IUIAutomation::GetRootElement 方法 (uiautomationclient.h)
擷取代表桌面的 使用者介面自動化 專案。
語法
HRESULT GetRootElement(
[out, retval] IUIAutomationElement **root
);
參數
[out, retval] root
類型: IUIAutomationElement**
接收 使用者介面自動化 專案的指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
您可以使用 FindAll 和 FindFirst 方法,使用根元素作為尋找其他元素的起點。
從根元素搜尋時,請務必在搜尋範圍內指定 TreeScope_Children ,而不是 TreeScope_Descendants。 透過桌面整個子樹的搜尋可能會逐一查看數千個專案,並導致堆疊溢位。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 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) |