Metode IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent (uiautomationclient.h)

Artikel
03/03/2024

Memetakan peristiwa Otomatisasi UI Microsoft ke WinEvents.

Sintaks

HRESULT SetWinEventsForAutomationEvent(
  [in] EVENTID    eventId,
  [in] PROPERTYID propertyId,
  [in] SAFEARRAY  *winEvents
);

Parameter

[in] eventId

Jenis: EVENTID

Pengidentifikasi peristiwa. Untuk daftar pengidentifikasi peristiwa, lihat Pengidentifikasi Peristiwa.

[in] propertyId

Jenis: PROPERTYID

Pengidentifikasi properti. Untuk daftar ID properti, lihat Pengidentifikasi Properti.

[in] winEvents

Jenis: SAFEARRAY*

Daftar WinEvents yang memetakan ke acara ini.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ketika aplikasi klien berlangganan peristiwa Automation UI, inti Automation UI juga mendengarkan WinEvents yang memetakan peristiwa ini. Misalnya, misalkan UIA_Invoke_InvokedEventId dipetakan ke EVENT_OBJECT_INVOKED. Ketika EVENT_OBJECT_INVOKED dinaikkan, klien membuat instans proksi dan memanggil RespondToWinEvent pada proksi tersebut. Dalam implementasi RespondToWinEvent, proksi memanggil AddAutomationEvent. Inti kemudian menaikkan peristiwa Otomatisasi UI yang sesuai.

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)