IUIAutomation::AddPropertyChangedEventHandlerNativeArray method (uiautomationclient.h)
Mendaftarkan metode yang menangani array asli peristiwa yang diubah properti.
Sintaks
HRESULT AddPropertyChangedEventHandlerNativeArray(
[in] IUIAutomationElement *element,
TreeScope scope,
[in] IUIAutomationCacheRequest *cacheRequest,
[in] IUIAutomationPropertyChangedEventHandler *handler,
[in] PROPERTYID *propertyArray,
[in] int propertyCount
);
Parameter
[in] element
Jenis: IUIAutomationElement*
Penunjuk ke elemen Automation UI yang terkait dengan penanganan aktivitas.
scope
[in] cacheRequest
Jenis: IUIAutomationCacheRequest*
Penunjuk ke permintaan cache, atau NULL jika tidak ada penembolokan yang diinginkan.
[in] handler
Jenis: IUIAutomationPropertyChangedEventHandler*
Penunjuk ke objek yang menangani peristiwa.
[in] propertyArray
Jenis: PROPERTYID*
Penunjuk ke pengidentifikasi properti Automation UI yang menarik. Untuk daftar ID properti, lihat Pengidentifikasi Properti.
[in] propertyCount
Jenis: int
Jumlah pengidentifikasi properti di propertyArray.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
contoh
Untuk contoh kode yang menunjukkan cara mengimplementasikan antarmuka yang memungkinkan klien menerima dan menangani peristiwa Microsoft UI Automation (termasuk AddPropertyChangedEventHandlerNativeArray), lihat Cara Menerapkan Penanganan Aktivitas.
Keterangan
Item UI yang ditentukan oleh elemen mungkin tidak mendukung properti yang ditentukan oleh parameter propertyArray .
Metode ini melayani tujuan yang sama dengan IUIAutomation::AddPropertyChangedEventHandler, tetapi mengambil array pengidentifikasi properti normal alih-alih SAFEARRAY.
Klien Automation UI tidak boleh menggunakan beberapa utas untuk menambahkan atau menghapus penanganan aktivitas. Perilaku tak terduga dapat mengakibatkan satu penanganan aktivitas ditambahkan atau dihapus saat yang lain sedang ditambahkan atau dihapus dalam proses klien yang sama.
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
AddPropertyChangedEventHandler
Properti Automasi antarmuka pengguna penembolokan dan Pola Kontrol
Konseptual
Referensi
RemovePropertyChangedEventHandler
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