Bagikan melalui

Antarmuka IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Artikel

Mengekspos metode yang dipanggil untuk memberi tahu elemen akar fragmen saat aplikasi klien Microsoft UI Automation dimulai atau berakhir mendengarkan peristiwa pada fragmen tersebut.

Warisan

Antarmuka IRawElementProviderAdviseEvents mewarisi dari antarmuka IUnknown . IRawElementProviderAdviseEvents juga memiliki jenis anggota ini:

Metode

Antarmuka IRawElementProviderAdviseEvents memiliki metode ini.

 
IRawElementProviderAdviseEvents::AdviseEventAdded

Memberi tahu penyedia Microsoft UI Automation saat klien Automation UI mulai mendengarkan peristiwa tertentu, termasuk peristiwa yang diubah properti.
IRawElementProviderAdviseEvents::AdviseEventRemoved

Memberi tahu penyedia Microsoft UI Automation saat klien Automation UI berhenti mendengarkan peristiwa tertentu, termasuk peristiwa yang diubah properti.

Keterangan

Implementasi antarmuka ini bersifat opsional. Ini dapat digunakan untuk meningkatkan performa dengan menaikkan peristiwa hanya ketika mereka sedang didengarkan.

Mirip dengan menerapkan penghitungan referensi dalam pemrograman Model Objek Komponen (COM), penting bagi penyedia Otomatisasi UI untuk memperlakukan metode AdviseEventAdded dan AdviseEventRemoved seperti metode AddRef dan Rilis antarmuka IUnknown . Selama AdviseEventAdded telah dipanggil lebih banyak kali daripada AdviseEventRemoved untuk peristiwa atau properti tertentu, penyedia harus terus meningkatkan peristiwa yang sesuai, karena beberapa klien masih mendengarkan. Atau, penyedia Automation UI dapat menggunakan fungsi UiaClientsAreListening untuk menentukan apakah setidaknya satu klien mendengarkan dan, jika demikian, menaikkan semua peristiwa yang sesuai.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header uiautomationcore.h (termasuk UIAutomation.h)