Metode IUIAutomation::GetRootElementBuildCache (uiautomationclient.h)

Mengambil elemen Automation UI yang mewakili desktop, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache.

Sintaks

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

Parameter

[in] cacheRequest

Jenis: IUIAutomationCacheRequest*

Penunjuk ke permintaan cache, yang menentukan properti dan pola kontrol untuk disimpan di cache.

[out, retval] root

Jenis: IUIAutomationElement**

Menerima penunjuk ke elemen Automation UI.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Anda dapat menggunakan elemen akar sebagai titik awal untuk menemukan elemen lain, menggunakan metode FindAll dan FindFirst .

Saat mencari dari elemen akar, pastikan untuk menentukan TreeScope_Children dalam cakupan pencarian, bukan TreeScope_Descendants. Pencarian melalui seluruh subtree desktop dapat melakukan iterasi melalui ribuan item dan menyebabkan luapan tumpukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)

Lihat juga

IUIAutomation

IUIAutomation::GetRootElement