Bagikan melalui

Alat aksesibilitas - AccEvent (Pengamat Peristiwa yang Dapat Diakses)

  • Artikel

AccEvent (Accessible Event Watcher) memungkinkan pengembang dan penguji untuk memvalidasi bahwa elemen UI aplikasi meningkatkan peristiwa Microsoft UI Automation dan Microsoft Active Accessibility yang tepat saat perubahan UI terjadi. Perubahan dalam UI dapat terjadi ketika fokus berubah, atau ketika elemen UI dipanggil, dipilih, atau memiliki perubahan status atau properti.

AccEvent diinstal dengan Windows Software Development Kit (SDK). Ini terletak di folder \bin\<version>\<platform> dari jalur penginstalan SDK (Accevent.exe).

Catatan

AccEvent adalah alat warisan. Sebaiknya gunakan Accessibility Insights sebagai gantinya.

Persyaratan

AccEvent dapat digunakan untuk memeriksa data aksesibilitas pada sistem yang tidak memiliki Automasi UI, awalnya ditulis untuk Aksesibilitas Aktif Microsoft. Untuk memeriksa Automasi UI, Automasi UI harus ada pada sistem. Untuk informasi selengkapnya, lihat bagian "Persyaratan" dari Automasi UI.

AccEvent diinstal sebagai bagian dari serangkaian alat keseluruhan di Windows SDK, itu tidak didistribusikan sebagai unduhan exe terpisah. Windows SDK menyertakan semua alat terkait aksesibilitas yang didokumentasikan di bagian ini. Dapatkan Windows SDK. (Ada juga arsip unduhan SDK yang ditautkan dari halaman tersebut, jika Anda memerlukan versi sebelumnya.)

Untuk menjalankan AccEvent, temukan AccEvent.exe di folder \bin\<version>\<platform> dan jalankan (Biasanya Anda tidak perlu menjalankan sebagai administrator).

Jendela Event Watcher yang Dapat Diakses

Saat Anda meluncurkan AccEvent, jendela utama ditampilkan. Jendela AccEvent utama menampilkan peristiwa Otomatisasi UI atau Aksesibilitas Aktif Microsoft yang dinaikkan oleh aplikasi yang sedang berjalan. Jendela utama memiliki bagian utama berikut:

  • Bilah judul. Menampilkan mode operasi dan status saat ini.
  • Bilah menu. Menyediakan akses ke fungsionalitas AccEvent .
  • Tampilan data. Menampilkan informasi tentang setiap peristiwa, termasuk ID peristiwa dan properti yang dipilih dari elemen UI yang menaikkan peristiwa.

AccEvent hanya memiliki antarmuka pengguna grafis; tidak ada argumen baris perintah untuk alat ini, tetapi Anda dapat menggunakan alat lain untuk memproses log output sebagai teks.

Gambar berikut menunjukkan jendela AccEvent utama.

the user interface for the accessible event watcher tool

Tugas Event Watcher yang Dapat Diakses

Bagian ini mencakup informasi tentang tugas AccEvent yang umum digunakan.

Mengonfigurasi Mode Operasi

Anda menggunakan menu Mode untuk mengonfigurasi mode operasi AccEvent dan memilih pengaturan yang mengontrol perilaku alat. Anda dapat memilih opsi berikut.

Ketika opsi ini dipilih AccEvent melakukan ini
Selalu di Atas Muncul di atas antarmuka pengguna lain di layar.
Peristiwa UIA Menampilkan informasi tentang peristiwa Automasi UI.
WinEvents (Dalam Konteks) Menampilkan informasi tentang peristiwa Aksesibilitas Aktif Microsoft (WinEvents) yang diteruskan ke fungsi kait yang berada di ruang alamat server. Untuk informasi selengkapnya, lihat Fungsi Hook Dalam Konteks.
WinEvents (Di Luar Konteks) Menampilkan informasi tentang peristiwa Aksesibilitas Aktif Microsoft (WinEvents) yang diteruskan ke fungsi kait yang berada di ruang alamat klien. Untuk informasi selengkapnya, lihat Fungsi Hook Di Luar Konteks.
Perlihatkan Persegi Panjang Sorotan Menyoroti persegi panjang di sekitar elemen UI yang menaikkan peristiwa yang dipilih.
Perlihatkan TipsAlat Informasi Memperlihatkan informasi peristiwa dalam tipsalat.
Pengaturan Menampilkan kotak dialog Pengaturan Peristiwa UIA atau winEvent Pengaturan.

 

Memfilter Peristiwa Otomatisasi UI

Untuk mengonfigurasi peristiwa dan properti Automation UI yang ditampilkan di jendela AccEvent, klik menu Mode, pilih Peristiwa UIA, lalu pilih Pengaturan. Kotak dialog Pengaturan Peristiwa UIA ditampilkan. Anda juga dapat menggunakan kotak dialog ini untuk memfilter peristiwa.

Kotak dialog Pengaturan Peristiwa UIA berisi panel berikut:

  • Acara Global

    Pilih kotak centang FocusChangedEvent untuk menampilkan informasi tentang peristiwa yang diubah fokus global.

  • Jenis Peristiwa

    Pilih peristiwa yang Anda minati.

  • Cakupan

    Pilih elemen UI yang Anda inginkan untuk didengarkan AccEvent untuk peristiwa.

  • Sertakan peristiwa dari

    Pilih Turunan langsung jika Anda harus melihat peristiwa dari elemen turunan langsung elemen UI yang dipilih di panel Cakupan . Jika Anda ingin melihat peristiwa dari semua elemen turunan, pilih Semua Turunan.

  • Properti Laporan

    Pilih properti yang ingin Anda tampilkan setelah setiap peristiwa di jendela utama. Jika Tampilkan TipsAlat Informasi dipilih di menu Mode , properti yang dipilih juga ditampilkan dalam tipsalat.

Memfilter Peristiwa Aksesibilitas Aktif

Untuk mengonfigurasi peristiwa dan properti Aksesibilitas Aktif Microsoft yang ditampilkan di jendela AccEvent, klik menu Mode, pilih WinEvents (Dalam Konteks) atau WinEvents (Di Luar Konteks), lalu pilih Pengaturan. Kotak dialog WinEvent Pengaturan ditampilkan. Anda juga dapat menggunakan kotak dialog ini untuk memfilter peristiwa.

Kotak dialog WinEvent Pengaturan berisi panel berikut ini:

  • Objek

    Pilih objek yang Anda inginkan untuk didengarkan AccEvent untuk peristiwa. AccEvent dapat mendengarkan peristiwa yang berasal dari jendela, dari kursor, atau dari tanda sisipan. Jendela dipilih secara default.

  • Peristiwa

    Pilih peristiwa yang Anda minati. Semua peristiwa ditampilkan secara default.

  • Informasi Peristiwa

    Pilih informasi yang ingin Anda tampilkan setelah setiap nama peristiwa di jendela utama.

  • Properti Objek

    Pilih properti yang ingin Anda tampilkan setelah setiap peristiwa di jendela utama. Jika Tampilkan TipsAlat Informasi dipilih di menu Mode , properti yang dipilih juga ditampilkan dalam tipsalat. Nama, Peran, dan Status dipilih secara default.

  • Pemfilteran

    Pilih salah satu tombol radio di bagian pemfilteran untuk memfilter peristiwa yang dimunculkan oleh jendela yang ditentukan di bidang hWND . Tombol Jangan filter radio dipilih secara default.

    • Pilih tombol Kecualikan radio untuk menampilkan hanya peristiwa yang dinaikkan dari objek selain jendela yang ditentukan.
    • Pilih tombol radio Sertakan saja dan tentukan satu atau beberapa handel jendela untuk menampilkan hanya peristiwa yang dinaikkan dari jendela tersebut.
    • Centang kotak centang dan Turunan untuk menyertakan peristiwa yang dimunculkan oleh turunan jendela yang ditentukan.

  • Opsi

    Pilih salah satu opsi berikut:

    Ketika opsi ini dipilih AccEvent melakukan ini
    Gunakan Panggil Menggunakan IDispatch::Invoke untuk mengambil properti objek alih-alih menggunakan metode IAccessible.
    Selalu Dapatkan Objek (meskipun tidak ada properti objek yang dipilih) Mengambil objek yang terkait dengan peristiwa meskipun tidak ada item yang dipilih di panel Properti Objek.
    Tampilkan properti default (selain properti yang dipilih) Menampilkan properti default, jika ada, untuk objek yang terkait dengan peristiwa, bersama dengan item yang dipilih di panel Properti Objek.
    Menampilkan informasi peristiwa dari jendela yang tidak terlihat/tersembunyi Menampilkan item terpilih dari panel Informasi Peristiwa untuk semua objek, termasuk item dalam jendela yang tidak terlihat atau tersembunyi.
    Menampilkan informasi kejadian lengkap dari jendela yang tidak terlihat/tersembunyi Menampilkan item terpilih dari panel Informasi Peristiwa, dan item yang dipilih (atau default) dari panel Properti Objek, untuk semua objek, termasuk item di jendela yang tidak terlihat atau tersembunyi.
    DebugBreak pada peristiwa berikutnya Menyebabkan pengecualian titik henti terjadi dalam proses yang berasal dari WinEvent berikutnya. Ini memberi sinyal debugger untuk menangani pengecualian.

Menggunakan Menu Peristiwa

Gunakan menu Peristiwa untuk melakukan tugas berikut:

Ketika opsi ini dipilih AccEvent melakukan ini
Mulai Mendengarkan Mulai menampilkan informasi peristiwa dalam tampilan Data.
Berhenti Mendengarkan Berhenti menampilkan informasi peristiwa dalam tampilan Data.
Bersihkan Riwayat Peristiwa Menghapus konten tampilan Data.
Pilih Semua Peristiwa Memilih semua peristiwa yang tercantum dalam tampilan Data.
Salin Peristiwa terpilih Menyalin peristiwa terpilih ke papan klip.

Menyimpan Peristiwa Aksesibilitas Aktif

Untuk mulai menyimpan peristiwa ke file teks, buka menu File dan pilih Mulai Pengelogan ke File. AccEvent mulai menulis peristiwa ke file yang ditentukan hingga Anda memilih Hentikan Pengelogandari menu File . File teks dapat berguna untuk memecahkan masalah dan meninjau peristiwa di lain waktu.