Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Die Ereignisbenachrichtigung der Microsoft UI-Automatisierung ist eine wichtige Funktion für Hilfstechnologien wie Bildschirmleseprogramme und Bildschirmlupen. Diese Benutzeroberflächenautomatisierungs-Clients verfolgen Ereignisse, die von Benutzeroberflächenautomatisierungs-Anbietern ausgelöst werden, wenn etwas in der Benutzeroberfläche geschieht, und verwenden Sie die Informationen, um Endbenutzer zu benachrichtigen.
Die Effizienz wird verbessert, indem Anbieteranwendungen das selektive Auslösen von Ereignissen ermöglichen, je nachdem, ob Clients diese Ereignisse abonniert haben oder gar nicht, wenn keine Clients auf Ereignisse lauschen.
Ereignistypen
Ereignisse der Benutzeroberflächenautomatisierung sind in die folgenden Kategorien unterteilt.
| Ereignis | BESCHREIBUNG |
|---|---|
| Eigenschaftsänderung | Wird ausgelöst, wenn sich eine Eigenschaft in einem Benutzeroberflächenautomatisierungs-Element oder Steuerelementmuster ändert. Wenn ein Client beispielsweise das Kontrollkästchen-Steuerelement einer Anwendung überwachen muss, kann er sich mithilfe der ToggleState -Eigenschaft registrieren, um auf ein Eigenschaftenänderungsereignis zu warten. Wenn das Kontrollkästchen-Steuerelement aktiviert oder deaktiviert wird, löst der Anbieter das Ereignis aus, und der Client kann entsprechend reagieren. |
| Element-Aktion | Wird ausgelöst, wenn eine Änderung der Benutzeroberfläche durch Aktivitäten von Endbenutzern oder programmgesteuerte Aktivitäten erfolgt; zum Beispiel, wenn eine Schaltfläche angeklickt oder durch InvokePattern aufgerufen wird. |
| Strukturänderung | Wird ausgelöst, wenn sich die Struktur des UI-Automatisierungsbaums ändert. Die Struktur ändert sich, wenn neue UI-Elemente auf dem Desktop sichtbar, ausgeblendet oder entfernt werden. |
| Globale Änderung des Desktops | Wird ausgelöst, wenn Aktionen von globalem Interesse für den Client auftreten, z. B. wenn der Fokus von einem Element auf ein anderes verschoben wird oder wenn ein Fenster geschlossen wird. |
Einige Ereignisse bedeuten nicht unbedingt, dass sich der Zustand der Benutzeroberfläche geändert hat. Wenn der Benutzer beispielsweise mit der Tabulatortaste zu einem Texteingabefeld wechselt und dann auf eine Schaltfläche klickt, um das Feld zu aktualisieren, wird eine TextChangedEvent ausgelöst, auch wenn der Benutzer den Text nicht tatsächlich geändert hat. Bei der Verarbeitung eines Ereignisses kann es erforderlich sein, dass eine Clientanwendung überprüfen muss, ob sich etwas tatsächlich geändert hat, bevor Eine Aktion ausgeführt wird.
Die folgenden Ereignisse können auch dann ausgelöst werden, wenn sich der Zustand der Benutzeroberfläche nicht geändert hat.
AutomationPropertyChangedEvent(abhängig von der Eigenschaft, die sich geändert hat)ElementSelectedEventInvalidatedEventTextChangedEvent
Benutzeroberflächenautomatisierungs-Ereignisbezeichner
Microsoft-Benutzeroberflächenautomatisierungs-Ereignisse werden durch AutomationEvent Objekte identifiziert. Die Id Eigenschaft enthält einen Wert, der die Art des Ereignisses eindeutig identifiziert.
Die möglichen Werte Id werden in der folgenden Tabelle zusammen mit dem Typ angegeben, der für Ereignisargumente verwendet wird. Beachten Sie, dass die von Clients und Anbietern verwendeten Bezeichner identisch benannte Felder aus verschiedenen Klassen sind.
Argumente für UI-Automatisierungsereignisse
Die folgenden Klassen kapseln Ereignisargumente.
| Klasse | BESCHREIBUNG |
|---|---|
| AsyncContentLoadedEventArgs | Enthält Informationen zum asynchronen Laden von Inhalten, einschließlich des Prozentsatzes des Ladefortschritts. |
| AutomationEventArgs | Enthält Informationen zu einem einfachen Ereignis, für das keine zusätzlichen Daten erforderlich sind. |
| AutomationFocusChangedEventArgs | Enthält Informationen zu einer Änderung des Eingabefokus von einem Element in ein anderes. Ereignisse dieses Typs werden vom Benutzeroberflächenautomatisierungssystem ausgelöst, nicht von Anbietern. |
| AutomationPropertyChangedEventArgs | Enthält Informationen zu einer Änderung eines Eigenschaftswerts eines Elements oder Steuerelementmusters. |
| StructureChangedEventArgs | Enthält Informationen zu einer Änderung im Benutzeroberflächenautomatisierungs-Baum. |
| WindowClosedEventArgs | Enthält Informationen zum Schließen eines Fensters. |
Alle Ereignisargumentklassen enthalten ein EventId Element. Dieser Bezeichner ist in einer AutomationEventKapselung enthalten.
Die AutomationEvent Objekte, die zum Identifizieren von Ereignissen verwendet werden, werden von Anbietern aus Feldern in AutomationElementIdentifiers und Steuerungs-Pattern-Identifier-Klassen wie DockPatternIdentifiers abgerufen. Die entsprechenden Felder werden von Clientanwendungen aus Feldern in AutomationElement und Steuerelementmusterklassen wie DockPattern abgerufen.
Eine Liste der Ereignisbezeichner finden Sie unter Benutzeroberflächenautomatisierungsereignisse für Clients.