IUIAutomation3::AddTextEditTextChangedEventHandler method (uiautomationclient.h)

Artikel
03/13/2024

Mendaftarkan metode yang menangani peristiwa edit teks terprogram.

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

Sintaks

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parameter

[in] element

Jenis: IUIAutomationElement*

Penunjuk ke elemen Automation UI yang terkait dengan penanganan aktivitas.

[in] scope

Jenis: TreeScope

Cakupan peristiwa yang akan ditangani; Yaitu, apakah mereka berada di elemen itu sendiri, atau pada leluhur dan keturunannya.

[in] textEditChangeType

Jenis: TextEditChangeType

Jenis perubahan khusus yang akan didengarkan. Klien mendaftar untuk setiap jenis perubahan edit teks secara terpisah, sehingga sistem Automation UI dapat memeriksa pendengar terdaftar pada run-time dan menghindari meningkatkan peristiwa untuk perubahan pengeditan teks tertentu ketika tidak ada pendengar.

[in] cacheRequest

Jenis: IUIAutomationCacheRequest*

Penunjuk ke permintaan cache, atau NULL jika tidak ada penembolokan yang diinginkan.

[in] handler

Jenis: IUIAutomationTextEditTextChangedEventHandler*

Penunjuk ke objek yang menangani peristiwa edit teks terprogram.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan 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.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)