Benutzeroberflächenautomatisierungs-Unterstützung für den Window-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
In diesem Thema erhalten Sie Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Steuerelementtyp „Window“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Das Window-Steuerelement besteht aus dem Fensterrahmen, der untergeordnete Objekte wie Titelleiste, Client sowie andere Objekte enthält.
Die Anforderungen an die Benutzeroberflächenautomatisierung in den folgenden Abschnitten gelten für alle Steuerelemente, die den Steuerelementtyp „Window“ implementieren. Dies gilt unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Fenstersteuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Fenster | Fenster |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für Fenstersteuerelemente von besonderem Interesse ist. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Das Window-Steuerelement muss einen durch Klicken aktivierbaren Punkt aufweisen, der dazu führt, dass das Fenster aktiviert oder deaktiviert wird. |
| ControlTypeProperty | Fenster | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| IsContentElementProperty | True | Das Window-Steuerelement muss immer ein Inhaltselement sein. |
| IsControlElementProperty | True | Das Window-Steuerelement muss immer ein Steuerelement sein. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| LabeledByProperty | null |
Window-Steuerelemente haben keine statische Fensterbezeichnung. |
| LocalizedControlTypeProperty | „Fenster“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „Window“. |
| NameProperty | Siehe Hinweise. | Das Window-Steuerelement enthält stets ein primäres Fensterelement, das sich auf den Bezeichner bezieht, den der Benutzer als bedeutungsvollsten Bezeichner mit dem Element assoziieren würde. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Fenstersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Notizen |
|---|---|---|
| IDockProvider | Bedingt | Muss unterstützt werden, wenn das Fenster angedockt werden kann. |
| ITransformProvider | Erforderlich | Ermöglicht das Verschieben, Ändern der Größe oder Drehen des Fensters auf dem Bildschirm. |
| IWindowProvider | Erforderlich | Ermöglicht bestimmte Vorgänge für das Fenster. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Fenstersteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Notizen |
|---|---|---|
| AsyncContentLoadedEvent | Erforderlich | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| LayoutInvalidatedEvent | Erforderlich | Keine |
| Durch geänderteNameProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |
| Durch geänderteHorizontallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteHorizontalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticalScrollPercentProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticallyScrollableProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| Durch geänderteVerticalViewSizeProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |
| WindowClosedEvent | Erforderlich | Keine |
| WindowOpenedEvent | Erforderlich | Keine |
| Durch geänderteWindowVisualStateProperty -Eigenschaft ausgelöstes Ereignis. | Depends (Abhängig) | Keine |