IUIAutomation6::RemoveActiveTextPositionChangedEventHandler metode (uiautomationclient.h)

Menghapus penanganan aktivitas yang diubah posisi teks aktif.

Penting

Klien Microsoft UI Automation harus menggunakan metode antarmuka IUIAutomationEventHandlerGroup untuk mendaftarkan pendengar peristiwa alih-alih metode pendaftaran peristiwa individual yang ditentukan di sini dan di berbagai namespace antarmuka IUIAutomation .

Sintaks

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Parameter

[in] element

Penunjuk ke elemen Automation UI yang terkait dengan penanganan aktivitas.

[in] handler

Penunjuk ke objek yang menangani peristiwa perubahan posisi teks aktif.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

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

Posisi teks aktif ditunjukkan oleh peristiwa navigasi di dalam atau di antara elemen teks baca-saja (seperti browser web, dokumen Portable Document Format (PDF), atau dokumen EPUB ) menggunakan marka buku (atau pengidentifikasi fragmen untuk merujuk ke lokasi dalam sumber daya). Contoh meliputi:

• Menavigasi ke bookmark dalam halaman web yang sama
• Menavigasi ke bookmark di halaman web lain
• Mengaktifkan tautan ke lokasi lain dalam PDF yang sama
• Mengaktifkan tautan ke lokasi lain dalam EPUB yang sama

Gunakan penanganan aktivitas ini untuk menyinkronkan lokasi visual marka buku/target dengan lokasi fokus dalam elemen teks baca-saja, yang dapat menyimpang saat menggunakan marka buku atau pengidentifikasi fragmen.

Misalnya, ketika jangkar halaman yang sama (<a href="#C4">Jump to Chapter 4</a> ...<h1><a name="C4">Chapter 4</a></h1>) dipanggil, lokasi visual diperbarui, tetapi klien Automation UI tetap berada di lokasi asli. Ini menghasilkan tindakan seperti membaca teks atau memindahkan perintah item berikutnya mulai dari lokasi asli, bukan lokasi baru.

Demikian pula, mengaktifkan URI halaman baru (dengan pengidentifikasi fragmen: (<a href="www.blah.com#C4">Jump to Chapter 4</a>) memuat halaman baru dan melompat ke marka buku yang ditentukan, tetapi meninggalkan klien Automation UI di bagian atas halaman.

Untuk elemen teks yang dapat diedit, seperti kontrol Edit dan Edit Kaya , Anda dapat mendengarkan peristiwa SelectionChanged.

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 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::AddActiveTextPositionChangedEventHandler, antarmuka IUIAutomation6