共用方式為


IUIAutomation::GetRootElementBuildCache 方法 (uiautomationclient.h)

擷取代表桌面的 使用者介面自動化 元素、預先擷取所要求的屬性和控制模式,並將預先擷取的專案儲存在快取中。

語法

HRESULT GetRootElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **root
);

參數

[in] cacheRequest

類型: IUIAutomationCacheRequest*

快取要求的指標,指定要儲存在快取中的屬性和控件模式。

[out, retval] root

類型: IUIAutomationElement**

接收 使用者介面自動化 專案的指標。

傳回值

類型: HRESULT

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

備註

您可以使用 FindAllFindFirst 方法,使用根元素作為尋找其他元素的起點。

從根元素搜尋時,請務必在搜尋範圍中指定 TreeScope_Children ,而不是 TreeScope_Descendants。 透過桌面整個子樹的搜尋可能會逐一查看數千個專案,並導致堆疊溢位。

規格需求

需求
最低支援的用戶端 Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用於 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)

另請參閱

IUIAutomation

IUIAutomation::GetRootElement