IUIAutomationElement::FindFirst method (uiautomationclient.h)
Mengambil elemen turunan atau anak pertama yang cocok dengan kondisi yang ditentukan.
Sintaks
HRESULT FindFirst(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[out, retval] IUIAutomationElement **found
);
Parameter
scope
[in] condition
Jenis: IUIAutomationCondition*
Penunjuk ke kondisi yang mewakili kriteria yang cocok.
[out, retval] found
Jenis: IUIAutomationElement**
Menerima penunjuk ke elemen . NULL dikembalikan jika tidak ada elemen yang cocok yang ditemukan.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
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.
Fungsi ini mengabaikan elemen di pohon mentah. Panggil FindFirstBuildCache untuk mencari pohon mentah dengan menentukan TreeScope yang sesuai pada IUIAutomationCacheRequest yang diteruskan ke fungsi tersebut.
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
Konseptual
Mendapatkan Elemen Automasi Antarmuka Pengguna
Referensi
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk