IUIAutomation::AddPropertyChangedEventHandlerNativeArray method (uiautomationclient.h)

Artikel
08/26/2023

Mendaftarkan metode yang menangani array asli peristiwa yang diubah properti.

Catatan Sebelum menerapkan penanganan aktivitas, Anda harus terbiasa dengan masalah utas yang dijelaskan dalam Memahami Masalah Utas.

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)