Udostępnij przez

Narzędzia ułatwień dostępu — AccEvent (dostępny obserwator zdarzeń)

Program AccEvent (dostępny obserwator zdarzeń) umożliwia deweloperom i testerom sprawdzenie, czy elementy interfejsu użytkownika aplikacji zgłaszają odpowiednie zdarzenia automatyzacji interfejsu użytkownika firmy Microsoft i aktywnego ułatwień dostępu firmy Microsoft w przypadku wystąpienia zmian interfejsu użytkownika. Zmiany w interfejsie użytkownika mogą wystąpić w przypadku zmiany fokusu lub wywołania elementu interfejsu użytkownika, wybrania lub zmiany stanu lub właściwości.

Program AccEvent jest instalowany z zestawem Windows Software Development Kit (SDK). Znajduje się on w folderze \bin\<version>\<platform> ścieżki instalacji zestawu SDK (Accevent.exe).

Uwaga

AccEvent to starsze narzędzie. W zamian zalecamy używanie Accessibility Insights.

Wymagania

Program AccEvent może służyć do sprawdzania danych ułatwień dostępu w systemach, które nie mają automatyzacji interfejsu użytkownika, została pierwotnie napisana dla usługi Microsoft Active Accessibility. Aby sprawdzić automatyzację interfejsu użytkownika, automatyzacja interfejsu użytkownika musi być obecna w systemie. Aby uzyskać więcej informacji, zobacz sekcję "Wymagania" automatyzacji interfejsu użytkownika.

Program AccEvent jest instalowany jako część ogólnego zestawu narzędzi w zestawie Windows SDK, nie jest dystrybuowany jako oddzielny plik exe do pobrania. Zestaw Windows SDK zawiera wszystkie narzędzia związane z ułatwieniami dostępu opisane w tej sekcji. Pobierz zestaw Windows SDK. (Istnieje również archiwum pobierania zestawu SDK połączone ze strony, jeśli potrzebujesz poprzedniej wersji).

Aby uruchomić program AccEvent, znajdź AccEvent.exe w folderze \bin\version>\<<platform> i uruchom go (zazwyczaj nie trzeba uruchamiać jako administrator).

Okno dostępnego obserwatora zdarzeń

Po uruchomieniu programu AccEvent zostanie wyświetlone główne okno. Główne okno AccEvent wyświetla zdarzenia automatyzacji interfejsu użytkownika lub usługi Microsoft Active Accessibility zgłaszane przez uruchomione aplikacje. Główne okno ma następujące główne części:

  • Pasek tytułu. Wyświetla bieżący tryb operacyjny i stan.
  • Pasek menu. Zapewnia dostęp do funkcji AccEvent .
  • Widok danych. Wyświetla informacje o każdym zdarzeniu, w tym identyfikator zdarzenia i wybrane właściwości elementu interfejsu użytkownika, który wywołał zdarzenie.

AccEvent ma tylko graficzny interfejs użytkownika; nie ma argumentów wiersza polecenia dla tego narzędzia, ale można użyć innych narzędzi do przetwarzania dziennika danych wyjściowych jako tekstu.

Na poniższej ilustracji przedstawiono główne okno AccEvent .

interfejs użytkownika dla dostępnego narzędzia do obserwatora zdarzeń

Dostępne zadania obserwatora zdarzeń

Ta sekcja zawiera informacje o często używanych zadaniach programu AccEvent .

Konfigurowanie trybu operacyjnego

Użyj menu Tryb , aby skonfigurować tryb operacyjny AccEvent i wybrać ustawienia kontrolujące zachowanie narzędzia. Możesz wybrać następujące opcje.

Po wybraniu tej opcji AccEvent to robi
Zawsze na górze Pojawia się na wierzchu dowolnego innego interfejsu użytkownika na ekranie.
Zdarzenia UIA Wyświetla informacje o zdarzeniach automatyzacji interfejsu użytkownika.
WinEvents (w kontekście) Przedstawia informacje o zdarzeniach Microsoft Active Accessibility (WinEvents) przekazywanych do funkcji zaczepienia, które znajdują się w przestrzeni adresowej serwera. Aby uzyskać więcej informacji, zobacz funkcjeIn-Context Hook.
WinEvents (poza kontekstem) Przedstawia informacje o zdarzeniach Microsoft Active Accessibility (WinEvents) przekazywanych do funkcji zaczepienia, które znajdują się w przestrzeni adresowej klienta. Aby uzyskać więcej informacji, zobacz Out-of-Context Hook Functions (Funkcje punktów zaczepienia poza kontekstem).
Pokaż prostokąt wyróżnienia Wyróżnia prostokąt wokół elementu interfejsu użytkownika, który wzbudził wybrane zdarzenie.
Pokaż etykietkę narzędzia informacji Wyświetla informacje o zdarzeniach w etykietce narzędzia.
Ustawienia Wyświetla okno dialogowe Ustawienia zdarzeń interfejsu użytkownika lub Ustawienia winEvent .

 

Filtrowanie zdarzeń automatyzacji interfejsu użytkownika

Aby skonfigurować zdarzenia i właściwości automatyzacji interfejsu użytkownika wyświetlane w oknie AccEvent , kliknij menu Tryb , wybierz pozycję Zdarzenia UIA, a następnie wybierz pozycję Ustawienia. Zostanie wyświetlone okno dialogowe Ustawienia zdarzeń interfejsu użytkownika. Możesz również użyć tego okna dialogowego, aby filtrować zdarzenia.

Okno dialogowe Ustawienia zdarzeń interfejsu użytkownika zawiera następujące okienka:

  • Zdarzenia globalne

    Zaznacz pole wyboru FocusChangedEvent , aby wyświetlić informacje o globalnych zdarzeniach zmienionych fokusem.

  • typ zdarzenia

    Wybierz interesujące Cię zdarzenia.

  • Scope

    Wybierz element interfejsu użytkownika, który ma być nasłuchiwany przez program AccEvent pod kątem zdarzeń.

  • Uwzględnij zdarzenia z

    Wybierz pozycję Bezpośrednie elementy podrzędne , jeśli zdarzenia mają być widoczne z natychmiastowych elementów podrzędnych elementu interfejsu użytkownika wybranego w okienku Zakres . Jeśli chcesz wyświetlić zdarzenia ze wszystkich elementów potomnych, wybierz pozycję Wszystkie elementy potomne.

  • Właściwości raportu

    Wybierz właściwości, które mają być wyświetlane po każdym zdarzeniu w oknie głównym. Jeśli w menu Tryb zostanie wybrana etykietka narzędzia Pokaż informacje, wybrane właściwości będą również wyświetlane w etykietce narzędzia.

Filtrowanie aktywnych zdarzeń ułatwień dostępu

Aby skonfigurować zdarzenia i właściwości usługi Microsoft Active Accessibility wyświetlane w oknie AccEvent , kliknij menu Tryb , wybierz pozycję WinEvents (w kontekście) lub WinEvents (poza kontekstem), a następnie wybierz pozycję Ustawienia. Zostanie wyświetlone okno dialogowe Ustawienia WinEvent . Możesz również użyć tego okna dialogowego, aby filtrować zdarzenia.

Okno dialogowe Ustawienia WinEvent zawiera następujące okienka:

  • Obiekty

    Wybierz obiekty, których program AccEvent ma nasłuchiwać zdarzeń. Program AccEvent może nasłuchiwać zdarzeń pochodzących z okien, kursora lub karetki. Okno jest domyślnie zaznaczone.

  • Wydarzenia

    Wybierz interesujące Cię zdarzenia. Wszystkie zdarzenia są domyślnie wyświetlane.

  • Informacje o zdarzeniach

    Wybierz informacje, które mają być wyświetlane po nazwie każdego zdarzenia w oknie głównym.

  • Właściwości obiektu

    Wybierz właściwości, które mają być wyświetlane po każdym zdarzeniu w oknie głównym. Jeśli w menu Tryb zostanie wybrana etykietka narzędzia Pokaż informacje, wybrane właściwości będą również wyświetlane w etykietce narzędzia. Domyślnie wybierana jest nazwa, rola i stan .

  • Filtrowanie

    Wybierz jeden z przycisków radiowych w sekcji filtrowania, aby filtrować zdarzenia zgłoszone przez okna określone w polu hWNDs . Przycisk radiowy Nie filtruj jest domyślnie wybierany.

    • Wybierz przycisk radiowy Wyklucz , aby wyświetlić tylko zdarzenia wywoływane z obiektów innych niż określone okna.
    • Wybierz przycisk radiowy Uwzględnij tylko i określ co najmniej jeden uchwyt okna, aby wyświetlić tylko zdarzenia zgłaszane z tych okien.
    • Zaznacz pole wyboru i Elementy potomne , aby uwzględnić zdarzenia zgłoszone przez elementy podrzędne określonego okna.

  • Opcje

    Wybierz dowolną z następujących opcji:

    Po wybraniu tej opcji AccEvent to robi
    Korzystanie z wywołania Używa metody IDispatch::Invoke do pobierania właściwości obiektu zamiast przy użyciu metod IAccessible .
    Zawsze pobieraj obiekt (nawet jeśli nie wybrano właściwości obiektu) Pobiera obiekt skojarzony ze zdarzeniem, nawet jeśli w okienku Właściwości obiektu nie wybrano żadnych elementów.
    Wyświetl właściwość domyślną (oprócz wybranych właściwości) Wyświetla właściwość domyślną, jeśli istnieje, dla obiektu skojarzonego ze zdarzeniem wraz z elementami wybranymi w okienku Właściwości obiektu.
    Wyświetlanie informacji o zdarzeniach z niewidocznych/ukrytych okien Wyświetla wybrane elementy z okienka Informacje o zdarzeniu dla wszystkich obiektów, w tym tych w niewidocznych lub ukrytych oknach.
    Wyświetlanie pełnych informacji o zdarzeniu z niewidocznych/ukrytych okien Wyświetla wybrane elementy z okienka Informacje o zdarzeniu oraz wybrane (lub domyślne) elementy z okienka Właściwości obiektu dla wszystkich obiektów, w tym tych w niewidocznych lub ukrytych oknach.
    DebugBreak w następnym zdarzeniu Powoduje wystąpienie wyjątku punktu przerwania w procesie, który pochodzi z następnego rozwiązania WinEvent. Sygnalizuje to debuger do obsługi wyjątku.

Korzystanie z menu zdarzeń

Użyj menu Zdarzenie , aby wykonać następujące zadania:

Po wybraniu tej opcji AccEvent to robi
Rozpocznij nasłuchiwanie Rozpoczyna wyświetlanie informacji o zdarzeniu w widoku Dane.
Zatrzymaj nasłuchiwanie Zatrzymuje wyświetlanie informacji o zdarzeniu w widoku Dane.
Wyczyść historię zdarzeń Czyści zawartość widoku Dane.
Wybierz wszystkie zdarzenia Wybiera wszystkie zdarzenia wymienione w widoku Dane.
Kopiowanie wybranych zdarzeń Kopiuje wybrane zdarzenia do schowka.

Zapisywanie aktywnych zdarzeń ułatwień dostępu

Aby rozpocząć zapisywanie zdarzeń w pliku tekstowym, otwórz menu Plik i wybierz pozycję Rozpocznij rejestrowanie w pliku. Program AccEvent rozpoczyna zapisywanie zdarzeń do określonego pliku do momentu wybrania pozycji Zatrzymaj rejestrowanie z menu Plik . Plik tekstowy może być przydatny do rozwiązywania problemów i przeglądania zdarzeń w późniejszym czasie.

  • Last updated on