IUIAutomationElement::FindFirst method (uiautomationclient.h)
Mengambil elemen turunan atau turunan pertama yang cocok dengan kondisi yang ditentukan.
Sintaksis
HRESULT FindFirst(
[in] TreeScope scope,
[in] IUIAutomationCondition *condition,
[out, retval] IUIAutomationElement **found
);
Parameter
[in] scope
Kombinasi nilai yang menentukan cakupan pencarian.
[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.
Mengembalikan nilai
Jenis:
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,
Saat mencari jendela tingkat atas di desktop, pastikan untuk menentukan
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
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) |
Lihat juga
Konseptual
Mendapatkan Elemen Automation UI
Referensi