Barrierefreiheitstools – AccEvent (Barrierefreie Ereignisüberwachung)

AccEvent (Accessible Event Watcher) ermöglicht Entwicklern und Testern, zu überprüfen, ob die UI-Elemente einer Anwendung bei Änderungen an der Benutzeroberfläche die richtige Microsoft-Benutzeroberflächenautomatisierung und Microsoft Active Accessibility-Ereignisse auslösen. Änderungen an der Benutzeroberfläche können auftreten, wenn sich der Fokus ändert oder ein UI-Element aufgerufen, ausgewählt oder ein Zustand oder eine Eigenschaft geändert wird.

AccEvent- wird mit dem Windows Software Development Kit (SDK) installiert. Sie befindet sich im Ordner "\bin\"<Version>\<Plattform> Ordner des SDK-Installationspfads (Accevent.exe).

Anforderungen

AccEvent- kann verwendet werden, um Barrierefreiheitsdaten auf Systemen zu untersuchen, die nicht über die Benutzeroberflächenautomatisierung verfügen, es wurde ursprünglich für Microsoft Active Accessibility geschrieben. Um die Benutzeroberflächenautomatisierung zu untersuchen, muss die Benutzeroberflächenautomatisierung auf dem System vorhanden sein. Weitere Informationen finden Sie im Abschnitt "Anforderungen" benutzeroberflächenautomatisierung.

AccEvent- als Teil der gesamten Tools im Windows SDK installiert wird, wird sie nicht als separater EXE-Download verteilt. Das Windows SDK enthält alle in diesem Abschnitt dokumentierten Tools für die Barrierefreiheit. Rufen Sie das Windows SDK ab. (Es gibt auch ein SDK-Downloadarchiv, das von dieser Seite verknüpft ist, wenn Sie eine frühere Version benötigen.)

Wenn Sie AccEvent-ausführen möchten, suchen Sie AccEvent.exe in der \bin\<Version>\<Plattform> Ordners und führen Sie ihn aus (normalerweise müssen Sie nicht als Administrator ausgeführt werden).

Das Fenster "Barrierefreie Ereignisüberwachung"

Wenn Sie AccEvent-starten, wird das Hauptfenster angezeigt. Das Hauptfenster AccEvent zeigt die Benutzeroberflächenautomatisierungs- oder Microsoft Active Accessibility-Ereignisse an, die von Anwendungen ausgelöst werden, die ausgeführt werden. Das Hauptfenster weist die folgenden Hauptteile auf:

• Titelleiste. Zeigt den aktuellen Betriebsmodus und den aktuellen Zustand an.
• Menüleiste. Bietet Zugriff auf AccEvent- Funktionalität.
• Datenansicht. Zeigt Informationen zu jedem Ereignis an, einschließlich der Ereignis-ID und der ausgewählten Eigenschaften des UI-Elements, das das Ereignis ausgelöst hat.

AccEvent- verfügt nur über eine grafische Benutzeroberfläche; für dieses Tool gibt es keine Befehlszeilenargumente, sie können aber auch andere Tools verwenden, um das Ausgabeprotokoll als Text zu verarbeiten.

Die folgende Abbildung zeigt das Hauptfenster AccEvent-.

Aufgaben der Barrierefreiheitsereignisüberwachung

Dieser Abschnitt enthält Informationen zu häufig verwendeten AccEvent- Aufgaben.

Konfigurieren des Betriebsmodus

Sie verwenden das Menü Modus, um den AccEvent Betriebsmodus zu konfigurieren und Einstellungen auszuwählen, die das Verhalten des Tools steuern. Sie können die folgenden Optionen auswählen.

Filtern von Benutzeroberflächenautomatisierungsereignissen

Klicken Sie zum Konfigurieren der Im fenster AccEvent angezeigten Benutzeroberflächenautomatisierungsereignisse und -eigenschaften auf das Menü Modus, wählen Sie UIA-Ereignisseaus, und wählen Sie dann Einstellungenaus. Das Dialogfeld UIA-Ereigniseinstellungen wird angezeigt. Sie können dieses Dialogfeld auch verwenden, um nach Ereignissen zu filtern.

Das Dialogfeld UIA-Ereigniseinstellungen enthält die folgenden Bereiche:

• globale Ereignisse

  Aktivieren Sie das Kontrollkästchen FocusChangedEvent, um Informationen zu globalen Fokusänderungsereignissen anzuzeigen.

• Ereignistyp-

  Wählen Sie die Ereignisse aus, an denen Sie interessiert sind.

• Bereichs-

  Wählen Sie das UI-Element aus, AccEvent auf Ereignisse lauschen soll.

• Ereignisse aus einschließen

  Wählen Sie direkt untergeordneten Elemente aus, wenn Ereignisse aus den unmittelbaren untergeordneten Elementen des UI-Elements angezeigt werden sollen, das im Bereich Bereich ausgewählt ist. Wenn Ereignisse aus allen untergeordneten Elementen angezeigt werden sollen, wählen Sie Alle Nachfolgeraus.

• Berichtseigenschaften

  Wählen Sie die Eigenschaften aus, die nach jedem Ereignis im Hauptfenster angezeigt werden sollen. Wenn QuickInfo anzeigen im Menü Modus ausgewählt ist, werden die ausgewählten Eigenschaften auch in einer QuickInfo angezeigt.

Filtern aktiver Barrierefreiheitsereignisse

Klicken Sie zum Konfigurieren der Im fenster AccEvent angezeigten Microsoft Active Accessibility-Ereignisse und -Eigenschaften auf das Menü Modus, wählen Sie entweder WinEvents (Im Kontext) oder WinEvents (Außerhalb des Kontexts)aus, und wählen Sie dann Einstellungenaus. Das Dialogfeld WinEvent-Einstellungen wird angezeigt. Sie können dieses Dialogfeld auch verwenden, um nach Ereignissen zu filtern.

Das Dialogfeld WinEvent-Einstellungen enthält die folgenden Bereiche:

• Objekte

  Wählen Sie die Objekte aus, die AccEvent- auf Ereignisse lauschen sollen. AccEvent- können ereignisse überwachen, die von Fenstern, vom Cursor oder vom Caret stammen. Fenster- ist standardmäßig aktiviert.

• Ereignisse

  Wählen Sie die Ereignisse aus, an denen Sie interessiert sind. Alle Ereignisse werden standardmäßig angezeigt.

• Ereignisinformationen

  Wählen Sie die Informationen aus, die nach dem Namen jedes Ereignisses im Hauptfenster angezeigt werden sollen.

• -Objekteigenschaften

  Wählen Sie die Eigenschaften aus, die nach jedem Ereignis im Hauptfenster angezeigt werden sollen. Wenn QuickInfo anzeigen im Menü Modus ausgewählt ist, werden die ausgewählten Eigenschaften auch in einer QuickInfo angezeigt. Name, Rolleund Status sind standardmäßig aktiviert.

• Filterung

  Wählen Sie eines der Optionsfelder im Filterabschnitt aus, um die ereignisse zu filtern, die von den im Feld angegebenen Fenstern ausgelöst wurden. Das Optionsfeld Nicht filtern ist standardmäßig aktiviert.

  • Wählen Sie die Optionsfeld ausschließen aus, um nur die Ereignisse anzuzeigen, die von anderen Objekten als den angegebenen Fenstern ausgelöst wurden.
  • Wählen Sie die Optionsfeld "Nur einschließen" aus, und geben Sie einen oder mehrere Fensterziehpunkte an, um nur Ereignisse anzuzeigen, die von diesen Fenstern ausgelöst werden.
  • Aktivieren Sie das Kontrollkästchen und Nachfolger, um Ereignisse einzuschließen, die von den Nachfolgern der angegebenen Fenster ausgelöst werden.

• Optionen

  Wählen Sie eine der folgenden Optionen aus:

  Wenn diese Option ausgewählt ist	AccEvent führt dies aus
  Aufrufen verwenden	Verwendet IDispatch::Invoke, um Objekteigenschaften abzurufen, anstatt IAccessible Methoden zu verwenden.
  Immer Objekt abrufen (auch wenn keine Objekteigenschaften ausgewählt sind)	Ruft das dem Ereignis zugeordnete Objekt ab, auch wenn im Bereich "Objekteigenschaften" keine Elemente ausgewählt sind.
  Standardeigenschaft anzeigen (zusätzlich zu ausgewählten Eigenschaften)	Zeigt ggf. die Standardeigenschaft für das dem Ereignis zugeordnete Objekt zusammen mit den im Bereich "Objekteigenschaften" ausgewählten Elementen an.
  Anzeigen von Ereignisinformationen aus unsichtbaren/ausgeblendeten Fenstern	Zeigt die ausgewählten Elemente aus dem Bereich "Ereignisinformationen" für alle Objekte an, einschließlich der Elemente in unsichtbaren oder ausgeblendeten Fenstern.
  Vollständige Ereignisinformationen aus unsichtbaren/ausgeblendeten Fenstern anzeigen	Zeigt die ausgewählten Elemente aus dem Bereich "Ereignisinformationen" und die ausgewählten (oder standard) Elemente aus dem Bereich "Objekteigenschaften" für alle Objekte an, einschließlich der Elemente in unsichtbaren oder ausgeblendeten Fenstern.
  DebugBreak beim nächsten Ereignis	Bewirkt, dass eine Haltepunkt-Ausnahme im Prozess auftritt, der aus dem nächsten WinEvent stammt. Dadurch wird der Debugger signalisiert, die Ausnahme zu behandeln.

Verwenden des Menüs "Ereignis"

Verwenden Sie das Menü Ereignis, um die folgenden Aufgaben auszuführen:

Speichern aktiver Barrierefreiheitsereignisse

Um mit dem Speichern von Ereignissen in einer Textdatei zu beginnen, öffnen Sie das Menü Datei, und wählen Sie Protokollierung in Datei startenaus. AccEvent beginnt mit dem Schreiben von Ereignissen in die angegebene Datei, bis Sie Protokollierung beenden im Menü Datei auswählen. Die Textdatei kann für die Problembehandlung und die Überprüfung der Ereignisse zu einem späteren Zeitpunkt hilfreich sein.

Verwandte Themen

• Barrierefreiheitsereignisüberwachung
• Tests für Barrierefreiheits-
• Barrierefreiheitsprüfung der Benutzeroberfläche
• übersicht über Ereignisse der Benutzeroberflächenautomatisierung
• Benutzeroberflächenautomatisierung überprüfen
• WinEvents-