Aracılığıyla paylaş

Erişilebilirlik araçları - AccEvent (Erişilebilir Olay İzleyicisi)

AccEvent (Erişilebilir Olay İzleyicisi), geliştiricilerin ve test edenlerin, ui değişiklikleri gerçekleştiğinde uygulamanın kullanıcı arabirimi öğelerinin uygun Microsoft UI Otomasyonu ve Microsoft Etkin Erişilebilirlik olayları oluşturduğunu doğrulamalarına olanak tanır. Kullanıcı arabirimindeki değişiklikler odak değiştiğinde veya kullanıcı arabirimi öğesi çağrıldığında, seçildiğinde veya durum veya özellik değişikliği olduğunda oluşabilir.

AccEvent , Windows Yazılım Geliştirme Seti (SDK) ile birlikte yüklenir. SDK yükleme yolunun \bin\<version>\<platform> klasöründe bulunur (Accevent.exe).

Uyarı

AccEvent eski bir araçtır. Bunun yerine erişilebilirlik içgörüleri kullanmanızı öneririz.

Gereksinimler

AccEvent , UI Otomasyonu olmayan sistemlerde erişilebilirlik verilerini incelemek için kullanılabilir, başlangıçta Microsoft Etkin Erişilebilirlik için yazılmıştır. UI Otomasyonunu incelemek için SISTEMDE UI Otomasyonu bulunmalıdır. Daha fazla bilgi için ui otomasyonu "Gereksinimler" bölümüne bakın.

AccEvent , Windows SDK'daki genel araç kümesinin bir parçası olarak yüklenir, ayrı bir exe indirmesi olarak dağıtılmaz. Windows SDK'sı, bu bölümde belgelenen erişilebilirlikle ilgili tüm araçları içerir. Windows SDK'sını edinin. (Önceki bir sürüme ihtiyacınız varsa bu sayfadan bağlantılı bir SDK indirme arşivi de vardır.)

AccEvent'i çalıştırmak için \bin\version>\<<platform> klasöründe AccEvent.exe bulun ve çalıştırın (genellikle yönetici olarak çalıştırmanız gerekmez).

Erişilebilir Olay İzleyicisi Penceresi

AccEvent'i başlattığınızda ana pencere görüntülenir. Ana AccEvent penceresinde, çalışan uygulamalar tarafından tetiklenen UI Otomasyonu veya Microsoft Etkin Erişilebilirlik olayları görüntülenir. Ana pencerede aşağıdaki ana bölümler vardır:

  • Başlık çubuğu. Geçerli işletim modunu ve durumunu görüntüler.
  • Menü çubuğu. AccEvent işlevselliğine erişim sağlar.
  • Veri görünümü. Olayı oluşturan kullanıcı arabirimi öğesinin olay kimliği ve seçili özellikleri de dahil olmak üzere her olay hakkındaki bilgileri görüntüler.

AccEvent yalnızca grafik kullanıcı arabirimine sahiptir; bu araç için komut satırı bağımsız değişkeni yoktur, ancak çıkış günlüğünü metin olarak işlemek için diğer araçları kullanabilirsiniz.

Aşağıdaki görüntüde ana AccEvent penceresi gösterilmektedir.

erişilebilir olay izleyicisi aracının kullanıcı arabirimi

Erişilebilir Olay İzleyicisi Görevleri

Bu bölüm yaygın olarak kullanılan AccEvent görevleri hakkında bilgi içerir.

İşletim Modunu Yapılandırma

AccEvent işletim modunu yapılandırmak ve aracın davranışını denetleyebilen ayarları seçmek için Mod menüsünü kullanırsınız. Aşağıdaki seçenekleri belirleyebilirsiniz.

Bu seçenek belirlendiğinde AccEvent bunu yapar
Her Zaman Üstte Ekrandaki diğer tüm kullanıcı arabirimlerinin üzerinde görünür.
UIA Olayları UI Otomasyonu olayları hakkındaki bilgileri görüntüler.
WinEvents (Bağlamda) Sunucu adres alanında bulunan kanca işlevlerine geçirilen Microsoft Etkin Erişilebilirlik olayları (WinEvents) hakkındaki bilgileri görüntüler. Daha fazla bilgi için bkz .In-Context Kanca İşlevleri.
WinEvents (Bağlam Dışı) İstemci adres alanında bulunan kanca işlevlerine geçirilen Microsoft Etkin Erişilebilirlik olayları (WinEvents) hakkındaki bilgileri görüntüler. Daha fazla bilgi için bkz. Bağlam Dışı Kanca İşlevleri.
Vurgulu Dikdörtgeni Göster Seçili olayı tetikleyen kullanıcı arabirimi öğesinin çevresinde bir dikdörtgeni vurgular.
Bilgi Araç İpucu'nu göster Olay bilgilerini bir araç ipucunda gösterir.
Ayarlar UIA Olay Ayarları veya WinEvent Ayarları iletişim kutusunu görüntüler.

 

UI Otomasyon Olaylarını Filtreleme

AccEvent penceresinde görüntülenen UI Otomasyonu olaylarını ve özelliklerini yapılandırmak için Mod menüsüne tıklayın, UIA Olayları'nı ve ardından Ayarlar'ı seçin. UIA Olay Ayarları iletişim kutusu görüntülenir. Olayları filtrelemek için bu iletişim kutusunu da kullanabilirsiniz.

UIA Olay Ayarları iletişim kutusu aşağıdaki bölmeleri içerir:

  • Genel Olaylar

    Genel odak değiştirme olayları hakkındaki bilgileri görüntülemek için FocusChangedEvent onay kutusunu seçin.

  • Olay Türü

    İlgilendiğiniz olayları seçin.

  • Scope

    AccEvent'in olaylar için dinlemesini istediğiniz kullanıcı arabirimi öğesini seçin.

  • Olayları dahil et

    Kapsam bölmesinde seçilen kullanıcı arabirimi öğesinin anlık alt öğelerinden olayları görmek istiyorsanız Anlık alt öğeler'i seçin. Tüm alt öğelerden gelen olayları görmek istiyorsanız Tüm Alt Öğeler'i seçin.

  • Rapor Özellikleri

    Ana pencerede her olaydan sonra görüntülenmesini istediğiniz özellikleri seçin. Mod menüsünde Bilgileri Göster Araç İpucu seçiliyse, seçilen özellikler bir araç ipucunda da görüntülenir.

Etkin Erişilebilirlik Olaylarını Filtreleme

AccEvent penceresinde görüntülenen Microsoft Etkin Erişilebilirlik olaylarını ve özelliklerini yapılandırmak için Mod menüsüne tıklayın, WinEvents (Bağlam İçinde) veya WinEvents (Bağlam Dışı) seçeneğini belirleyin ve ardından Ayarlar'ı seçin. WinEvent Ayarları iletişim kutusu görüntülenir. Olayları filtrelemek için bu iletişim kutusunu da kullanabilirsiniz.

WinEvent Ayarları iletişim kutusu aşağıdaki bölmeleri içerir:

  • Nesneler

    AccEvent'in olaylar için dinlemesini istediğiniz nesneleri seçin. AccEvent , pencerelerden, imleçten veya şapka işaretinden kaynaklanan olayları dinleyebilir. Pencere varsayılan olarak seçilidir.

  • Etkinlikler

    İlgilendiğiniz olayları seçin. Tüm olaylar varsayılan olarak görüntülenir.

  • Olay Bilgileri

    Ana pencerede her olayın adından sonra görüntülenmesini istediğiniz bilgileri seçin.

  • Nesne Özellikleri

    Ana pencerede her olaydan sonra görüntülenmesini istediğiniz özellikleri seçin. Mod menüsünde Bilgileri Göster Araç İpucu seçiliyse, seçilen özellikler bir araç ipucunda da görüntülenir. Ad, Rol ve Durum varsayılan olarak seçilidir.

  • Filtreleme

    hWNDs alanında belirtilen pencereler tarafından oluşturulan olayları filtrelemek için filtreleme bölümündeki radyo düğmelerinden birini seçin. Radyoyu filtreleme düğmesi varsayılan olarak seçilidir.

    • Yalnızca belirtilen pencereler dışındaki nesnelerden tetiklenen olayları görüntülemek için Radyoyu dışla düğmesini seçin.
    • Yalnızca ekle radyo düğmesini seçin ve yalnızca bu pencerelerden tetiklenen olayları görüntülemek için bir veya daha fazla pencere tutamacı belirtin.
    • Belirtilen pencerelerin alt öğeleri tarafından tetiklenen olayları eklemek için ve Alt Öğeler onay kutusunu işaretleyin.

  • Seçenekleri

    Aşağıdaki seçeneklerden birini belirleyin:

    Bu seçenek belirlendiğinde AccEvent bunu yapar
    Invoke kullanma IAccessible yöntemlerini kullanmak yerine nesne özelliklerini almak için IDispatch::Invoke kullanır.
    Her Zaman Nesne Al (hiçbir nesne özelliği seçilmese bile) Nesne Özellikleri bölmesinde hiçbir öğe seçilmese bile olayla ilişkili nesneyi alır.
    Varsayılan özelliği görüntüle (seçili özelliklere ek olarak) Varsa, olayla ilişkili nesnenin varsayılan özelliğini ve Nesne Özellikleri bölmesinde seçilen öğeleri görüntüler.
    Görünmez/gizli pencerelerden olay bilgilerini görüntüleme Görünmez veya gizli pencerelerdeki nesneler de dahil olmak üzere tüm nesneler için Olay Bilgileri bölmesinden seçilen öğeleri görüntüler.
    Görünmez/gizli pencerelerden tam olay bilgilerini görüntüleme Görünmez veya gizli pencerelerdekiler de dahil olmak üzere tüm nesneler için Olay Bilgileri bölmesinden seçilen öğeleri ve Nesne Özellikleri bölmesindeki seçili (veya varsayılan) öğeleri görüntüler.
    Sonraki olayda DebugBreak Sonraki WinEvent'i oluşturan işlemde kesme noktası özel durumunun oluşmasına neden olur. Bu, hata ayıklayıcıya özel durumu işlemesi için sinyal gönderir.

Olay Menüsünü Kullanma

Aşağıdaki görevleri gerçekleştirmek için Olay menüsünü kullanın:

Bu seçenek belirlendiğinde AccEvent bunu yapar
Dinlemeye Başlama Veri görünümünde olay bilgilerini görüntülemeye başlar.
Dinlemeyi Durdur Veri görünümünde olay bilgilerini görüntülemeyi durdurur.
Olay Geçmişini Temizle Veri görünümünün içeriğini temizler.
Tüm Olayları Seç Veri görünümünde listelenen tüm olayları seçer.
Seçili Olayları Kopyala Seçili olayları panoya kopyalar.

Etkin Erişilebilirlik Olaylarını Kaydetme

Olayları bir metin dosyasına kaydetmeye başlamak için Dosya menüsünü açın ve Dosyada Günlüğe Kaydetmeyi Başlat'ı seçin. AccEvent, Siz Dosya menüsünden Günlüğü Durdur'u seçene kadar belirtilen dosyaya olay yazmaya başlar. Metin dosyası, sorunları gidermek ve daha sonra olayları gözden geçirmek için yararlı olabilir.

  • Last updated on