IUIAutomationElement::FindFirstBuildCache method (uiautomationclient.h)

Artikel
08/08/2024

Mengambil elemen turunan atau turunan pertama yang cocok dengan kondisi yang ditentukan, mengambil properti dan pola kontrol yang diminta, dan menyimpan item yang telah diambil sebelumnya dalam cache.

Sintaksis

HRESULT FindFirstBuildCache(
  [in]          TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **found
);

Parameter

[in] scope

Jenis: TreeScope

Kombinasi nilai yang menentukan cakupan pencarian.

[in] condition

Jenis: IUIAutomationCondition*

Penunjuk ke kondisi yang mewakili kriteria yang cocok.

[in] cacheRequest

Jenis: IUIAutomationCacheRequest*

Penunjuk ke permintaan cache yang menentukan pola kontrol dan properti untuk disertakan dalam cache.

[out, retval] found

Jenis: IUIAutomationElement**

Menerima penunjuk ke elemen yang cocok, atau NULL jika tidak ada elemen yang cocok yang ditemukan.

Mengembalikan nilai

Jenis: HRESULT

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

Komentar

Cakupan pencarian relatif terhadap elemen tempat metode dipanggil. Elemen dikembalikan dalam urutan di mana mereka ditemui di pohon.

Fungsi ini tidak dapat mencari elemen leluhur di pohon Microsoft UI Automation; artinya, TreeScope_Ancestors bukan nilai yang valid untuk parameter cakupan .

Saat mencari jendela tingkat atas di desktop, pastikan untuk menentukan TreeScope_Children dalam parameter cakupan , bukan TreeScope_Descendants. Pencarian melalui seluruh subtree desktop dapat melakukan iterasi melalui ribuan item dan menyebabkan luapan tumpukan.

Jika aplikasi klien Anda mungkin mencoba menemukan elemen di antarmuka penggunanya sendiri, Anda harus melakukan semua panggilan Automation UI pada utas terpisah.

Untuk mencari pohon mentah, tentukan TreeScope yang sesuai di parameter cacheRequest .

Persyaratan

Syarat	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]
Platform Target	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)