Metode IUIAutomationTreeWalker::NormalizeElementBuildCache (uiautomationclient.h)
Mengambil elemen leluhur yang terdekat dengan elemen Microsoft UI Automation yang ditentukan dalam tampilan pohon, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache.
Sintaks
HRESULT NormalizeElementBuildCache(
[in] IUIAutomationElement *element,
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **normalized
);
Parameter
[in] element
Jenis: IUIAutomationElement*
Penunjuk ke elemen untuk memulai normalisasi.
[in] cacheRequest
Jenis: IUIAutomationCacheRequest*
Penunjuk ke permintaan cache yang menentukan properti dan pola kontrol untuk di-cache pada elemen yang dikembalikan.
[out, retval] normalized
Jenis: IUIAutomationElement**
Menerima penunjuk ke elemen leluhur yang terdekat dengan elemen yang ditentukan dalam tampilan pohon.
Mengembalikan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Elemen dinormalisasi dengan menavigasi rantai leluhur di pohon hingga elemen yang memenuhi kondisi tampilan (ditentukan oleh panggilan sebelumnya ke IUIAutomationTreeWalker::Condition) tercapai. Jika elemen akar tercapai, elemen akar dikembalikan, meskipun tidak memenuhi kondisi tampilan.
Metode ini berguna untuk aplikasi yang mendapatkan referensi ke elemen Automation UI dengan pengujian temuan. Aplikasi mungkin hanya ingin bekerja dengan jenis elemen tertentu, dan dapat menggunakan IUIAutomationTreeWalker::NormalizeElement untuk memastikan bahwa tidak peduli elemen apa yang awalnya diambil (misalnya, ketika bilah gulir mendapatkan fokus input), hanya elemen yang menarik (seperti elemen konten) yang pada akhirnya diambil.
Persyaratan
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) |
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