IUIAutomation::RemoveAutomationEventHandler method (uiautomationclient.h)
Menghapus penanganan aktivitas Automation UI yang ditentukan.
Sintaks
HRESULT RemoveAutomationEventHandler(
[in] EVENTID eventId,
[in] IUIAutomationElement *element,
[in] IUIAutomationEventHandler *handler
);
Parameter
[in] eventId
Jenis: EVENTID
Pengidentifikasi peristiwa yang sedang ditangani. Untuk daftar ID peristiwa, lihat Pengidentifikasi Peristiwa.
[in] element
Jenis: IUIAutomationElement*
Penunjuk ke elemen Automation UI yang menangani peristiwa.
[in] handler
Jenis: IUIAutomationEventHandler*
Penunjuk ke metode handler yang diteruskan ke IUIAutomation::AddAutomationEventHandler untuk pengidentifikasi peristiwa dan elemen Automation UI yang ditentukan.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
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.
Dimungkinkan bagi peristiwa untuk dikirimkan ke penanganan aktivitas setelah handler berhenti berlangganan, jika peristiwa diterima secara 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 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
RemoveFocusChangedEventHandler