Sdílet prostřednictvím

Nástroje pro usnadnění přístupu – AccEvent (Access Event Watcher)

  • Článek

AccEvent (Accessible Event Watcher) umožňuje vývojářům a testerům ověřit, jestli prvky uživatelského rozhraní aplikace při změně uživatelského rozhraní vyvolávají správné události Microsoft UI Automation a Microsoft Active Accessibility. Změny v uživatelském rozhraní mohou nastat při změně fokusu nebo při vyvolání, výběru nebo změně stavu nebo vlastnosti.

AccEvent se instaluje se sadou Windows Software Development Kit (SDK). Nachází se ve složce \bin\<verze>\<platformu> instalační cesty sady SDK (Accevent.exe).

Poznámka

AccEvent je starší nástroj. Místo toho doporučujeme používat přehledy přístupnosti.

Požadavky

AccEvent je možné použít k prozkoumání dat přístupnosti v systémech, které nemají automatizaci uživatelského rozhraní, původně byla napsána pro Microsoft Active Accessibility. Aby bylo možné prozkoumat automatizaci uživatelského rozhraní, musí být v systému k dispozici automatizace uživatelského rozhraní. Další informace naleznete v části Požadavky automatizace uživatelského rozhraní.

accEvent se instaluje jako součást celkové sady nástrojů v sadě Windows SDK, není distribuována jako samostatný soubor exe ke stažení. Sada Windows SDK obsahuje všechny nástroje související s přístupností popsané v této části. Získejte sadu Windows SDK. (Pokud potřebujete předchozí verzi, existuje také archiv pro stažení sady SDK z této stránky.)

Pokud chcete spustit AccEvent, najděte AccEvent.exe ve složce \bin\<verze>\<platformu> a spusťte ji (obvykle ji nemusíte spouštět jako správce).

Okno Sledování událostí s podporou přístupnosti

Když spustíte AccEvent, zobrazí se hlavní okno. Hlavní okno AccEvent zobrazuje události Automatizace uživatelského rozhraní nebo Microsoft Active Accessibility vyvolané aplikacemi, které jsou spuštěné. Hlavní okno má následující hlavní části:

  • Záhlaví. Zobrazí aktuální provozní režim a stav.
  • Panel nabídek. Poskytuje přístup k funkcím AccEvent.
  • Zobrazení dat. Zobrazí informace o každé události, včetně ID události a vybraných vlastností prvku uživatelského rozhraní, který událost vyvolal.

AccEvent má pouze grafické uživatelské rozhraní; tento nástroj neobsahuje žádné argumenty příkazového řádku, ale k zpracování výstupního protokolu jako textu můžete použít jiné nástroje.

Následující obrázek ukazuje hlavní okno AccEvent.

uživatelské rozhraní pro nástroj pro sledování událostí s podporou přístupnosti

Úlohy sledování událostí s podporou přístupnosti

Tato část obsahuje informace o běžně používaných úlohách accEvent.

Konfigurace provozního režimu

Pomocí nabídky Režim nakonfigurujete provozní režim AccEvent a vyberete nastavení, která řídí chování nástroje. Můžete vybrat následující možnosti.

Při výběru této možnosti AccEvent to dělá
Always on Top Zobrazí se nad jakýmkoli jiným uživatelským rozhraním na obrazovce.
Události UIA Zobrazí informace o událostech automatizace uživatelského rozhraní.
WinEvents (v kontextu) Zobrazí informace o událostech microsoft Active Accessibility (WinEvents) předávaných funkcím háku, které se nacházejí v adresního prostoru serveru. Další informace naleznete v tématu In-Context Hook Functions.
WinEvents (mimo kontext) Zobrazí informace o událostech Microsoft Active Accessibility (WinEvents) předávaných funkcím hooku, které se nacházejí v adresního prostoru klienta. Další informace najdete v tématu funkce háku mimo kontext.
Zobrazit obdélník zvýraznění Zvýrazní obdélník kolem prvku uživatelského rozhraní, který vyvolal vybranou událost.
Zobrazit popis informací Zobrazuje informace o události v popisu.
Nastavení Zobrazí nastavení událostí UIA nebo dialogové okno nastavení WinEvent.

 

Filtrování událostí automatizace uživatelského rozhraní

Chcete-li nakonfigurovat události a vlastnosti automatizace uživatelského rozhraní, které jsou zobrazeny v okně AccEvent, klepněte na nabídku Režim, vyberte Události UIAa pak vyberte Nastavení. Zobrazí se dialogové okno Nastavení událostí UIA. Toto dialogové okno můžete také použít k filtrování událostí.

Dialogové okno Nastavení událostí UIA obsahuje následující podokna:

  • globálních událostí

    Zaškrtnutím políčka FocusChangedEvent zobrazíte informace o globálních událostech změněných fokusem.

  • typ události

    Vyberte události, které vás zajímají.

  • oboru

    Vyberte prvek uživatelského rozhraní, který chcete accEvent naslouchat událostem.

  • zahrnout události z

    Pokud chcete zobrazit události z bezprostředně podřízených prvků prvku uživatelského rozhraní vybraného v podokně Rozsah, vyberte Okamžité podřízené položky. Pokud chcete zobrazit události ze všech následnických prvků, vyberte Všechny potomky.

  • vlastnosti sestavy

    Vyberte vlastnosti, které chcete zobrazit po každé události v hlavním okně. Pokud je v nabídce režim vybrán zobrazit popis informací, zobrazí se v popisu také vybrané vlastnosti.

Filtrování aktivních událostí přístupnosti

Chcete-li nakonfigurovat události a vlastnosti microsoft Active Accessibility zobrazené v okně AccEvent, klikněte na nabídku Režim, vyberte WinEvents (V kontextu) nebo WinEvents (Mimo kontext)a pak vyberte Nastavení. Zobrazí se dialogové okno Nastavení WinEvent. Toto dialogové okno můžete také použít k filtrování událostí.

Dialogové okno nastavení WinEvent obsahuje následující podokna:

  • objekty

    Vyberte objekty, které chcete AccEvent, aby naslouchaly událostem. AccEvent může naslouchat událostem pocházejícím z oken, kurzoru nebo kurzoru. okno je ve výchozím nastavení vybrané.

  • událostí

    Vyberte události, které vás zajímají. Ve výchozím nastavení se zobrazují všechny události.

  • informace o událostech

    Vyberte informace, které se mají zobrazit za názvem každé události v hlavním okně.

  • vlastnosti objektu

    Vyberte vlastnosti, které chcete zobrazit po každé události v hlavním okně. Pokud je v nabídce režim vybrán zobrazit popis informací, zobrazí se v popisu také vybrané vlastnosti. Název, Rolea State jsou ve výchozím nastavení vybrané.

  • filtrování

    Vyberte jedno z přepínačů v oddílu filtrování a vyfiltrujte události vyvolané okny zadanými v poli hWND. Přepínač Nefiltrovat je ve výchozím nastavení vybraný.

    • Výběrem přepínače Vyloučit zobrazte pouze události vyvolané z objektů kromě zadaných oken.
    • Vyberte přepínač Zahrnout pouze přepínač a zadejte jeden nebo více popisovačů okna, aby se zobrazily pouze události vyvolané z těchto oken.
    • Zaškrtnutím políčka a potomků zahrnout události vyvolané potomky zadaných oken.

  • možností

    Vyberte některou z následujících možností:

    Při výběru této možnosti AccEvent to dělá
    Použití vyvolání Používá IDispatch::Invoke k načtení vlastností objektu místo použití metod IAccessible.
    Vždy získat objekt (i když nejsou vybrány žádné vlastnosti objektu) Načte objekt přidružený k události, i když nejsou vybrány žádné položky v podokně Vlastnosti objektu.
    Zobrazit výchozí vlastnost (kromě vybraných vlastností) Zobrazí výchozí vlastnost, pokud existuje, pro objekt přidružený k události spolu s položkami vybranými v podokně Vlastnosti objektu.
    Zobrazení informací o událostech z neviditelných nebo skrytých oken Zobrazí vybrané položky z podokna Informace o události pro všechny objekty, včetně těch v neviditelných nebo skrytých oknech.
    Zobrazení úplných informací o událostech z neviditelných nebo skrytých oken Zobrazí vybrané položky z podokna Informace o události a vybrané (nebo výchozí) položky z podokna Vlastnosti objektu pro všechny objekty, včetně těch v neviditelných nebo skrytých oknech.
    DebugBreak při další události Způsobí, že dojde k výjimce zarážky v procesu, který pochází z další winEvent. To signalizuje ladicí program pro zpracování výjimky.

Použití nabídky událostí

Pomocí nabídky událostí proveďte následující úlohy:

Při výběru této možnosti AccEvent to dělá
Zahájit naslouchání Začne zobrazovat informace o událostech v zobrazení Data.
Zastavit naslouchání Přestane zobrazovat informace o událostech v zobrazení Data.
Vymazat historii událostí Vymaže obsah zobrazení Data.
Vybrat všechny události Vybere všechny události uvedené v zobrazení Data.
Kopírování vybraných událostí Zkopíruje vybrané události do schránky.

Ukládání aktivních událostí přístupnosti

Pokud chcete začít ukládat události do textového souboru, otevřete nabídku Soubor a vyberte Spustit protokolování do souboru. AccEvent začne zapisovat události do zadaného souboru, dokud v nabídce soubor nevyberete zastavit protokolování. Textový soubor může být užitečný pro řešení potíží a kontrolu událostí později.