IUIAutomation6::AddEventHandlerGroup method (uiautomationclient.h)

Mendaftarkan kumpulan metode penanganan aktivitas yang ditentukan dengan IUIAutomation6::CreateEventHandlerGroup.

Penting

Klien Microsoft UI Automation harus menggunakan metode grup handler untuk mendaftarkan pendengar peristiwa alih-alih metode pendaftaran peristiwa individual yang ditentukan dalam berbagai namespace antarmuka IUIAutomation .

Sintaks

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

Parameter

[in] element

Penunjuk ke elemen Automation UI yang terkait dengan grup penanganan aktivitas.

handlerGroup

Kumpulan pendengar peristiwa Automation UI.

Mengembalikan nilai

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

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

Dimungkinkan bagi peristiwa untuk dikirimkan ke penanganan aktivitas setelah handler dihentikan langganannya, jika peristiwa diterima bersamaan dengan permintaan untuk berhenti berlangganan acara. Praktik terbaik adalah mengikuti standar Model Objek Komponen (COM) dan menghindari penghancurkan objek penanganan aktivitas hingga jumlah referensinya mencapai nol. Menghancurkan penanganan aktivitas segera setelah berhenti berlangganan peristiwa dapat mengakibatkan pelanggaran akses jika suatu peristiwa dikirim terlambat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1809 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)

Lihat juga

IUIAutomation6::RemoveEventHandlerGroup, antarmuka IUIAutomation6