Benutzeroberflächenautomatisierung-Unterstützung für den TitleBar-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.
Dieses Thema enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „TitleBar“. 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.
TitleBar-Steuerelemente stellen Titel oder Titelleisten in einem Fenster dar.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „TitleBar“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Steuerelemente der Titelleiste, 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 Steuerelemente der Titelleiste 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 |
|---|---|
| TitleBar – Menü (0 oder 1) – Schaltfläche (0 oder mehr) |
Nicht zutreffend (Das TitleBar-Steuerelement enthält keinen Inhalt.) |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
Die folgende Tabelle enthält die Eigenschaften der Benutzeroberflächenautomatisierung, deren Werte oder Definitionen für TitleBar-Steuerelemente besonders relevant sind. 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 umschließende Rechteck einer Titelleiste muss alle darin enthaltenen Steuerelemente umfassen. |
| ClickablePointProperty | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht auf jeden Punkt innerhalb des umschließenden Rechtecks geklickt werden kann, und Sie spezielle Treffertests ausführen, setzen Sie die Eigenschaft außer Kraft, und stellen Sie dann einen klickbaren Punkt bereit. |
| IsKeyboardFocusableProperty | Falsch | Titelleisten verfügen niemals über den Tastaturfokus. |
| NameProperty | "" | Die Titelleiste ist kein Inhalt. Ihre Textinformationen werden auf dem übergeordneten Fenster verfügbar gemacht. |
| LabeledByProperty | Siehe Hinweise. | Das TitleBar-Steuerelement verfügt in der Regel über keine Bezeichnung. |
| ControlTypeProperty | TitleBar | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Titelleiste“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „TitleBar“. |
| IsContentElementProperty | Falsch | Das TitleBar-Steuerelement ist nie ein Inhaltselement. |
| IsControlElementProperty | True | Das TitleBar-Steuerelement muss immer ein Steuerelement sein. |
| IsOffscreenProperty | Depends (Abhängig) | Dieses Steuerelement gibt einen Wert in Abhängigkeit davon zurück, ob die Titelleiste auf dem Bildschirm angezeigt wird. |
| HelpTextProperty | "" | Es ist nicht erforderlich, Hilfetext bereitzustellen. |
| AcceleratorKeyProperty | "" | Titelleisten sind niemals Tastenkombinationen zugeordnet. |
| AccessKeyProperty | "" | Das TitleBar-Steuerelement verfügt über keine Zugriffstaste. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
Der TitleBar-Steuerelementtyp ist nicht erforderlich, um Steuerelementmuster zu unterstützen. Seine Funktionalität wird über das Window-Steuerelementmuster des Window-Steuerelements bereitgestellt.
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Steuerelementen der Titelleiste unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Hinweise |
|---|---|---|
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| AutomationFocusChangedEvent | Nie | Keine |
| StructureChangedEvent | Erforderlich | Keine |