AppBar-Steuerelementtyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den AppBar-Steuerelementtyp.
Eine App-Leiste ist ein Benutzeroberflächenelement, das dem Benutzer Navigation, Befehle und Tools präsentiert. Für Windows Store Apps können App-Balken für Apps angezeigt werden, indem Sie Windows Taste + Z drücken.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den AppBar-Steuerelementtyp definiert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Ereignisse
- Relevante Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur, die sich auf AppBar-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Button ist das gängigste Element in einer AppBar, aber auch andere Steuerelemente, die Aktionen für eine App aufrufen, sind möglich. Eine AppBar kann auch über 0 oder mehr Trennzeichen (Trennzeichen-Steuerelementtyp) verfügen, die in der Steuerelementansicht wie zwischen den anderen Steuerelementen platziert angezeigt werden. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für die Steuerelemente, die den AppBar-Steuerelementtyp implementieren, besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Der von dieser Eigenschaft verfügbar gemachte Wert muss sämtliche darin enthaltenen Steuerelemente umfassen. |
| UIA _ ControlTypePropertyId | AppBar | |
| UIA _ IsContentElementPropertyId | FALSE | Ein App-Balkensteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Ein App-Balkensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Steuerelemente in der App-Leiste können in der Regel den Tastaturfokus erhalten. |
| UIA _ IsOffscreenPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft ist hängt davon ab, ob das Steuerelement auf dem Bildschirm angezeigt werden kann. |
| UIA _ LabeledByPropertyId | Null | App-Balkensteuerelemente verfügen in der Regel nicht über eine Bezeichnung. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem AppBar-Steuerelementtyp entspricht. Der Standardwert ist "app bar" für en-US oder Englisch (USA). |
| _UIA-NamePropertyId | Siehe Hinweise. | Das App-Balkensteuerelement benötigt nur dann einen Namen, wenn eine Anwendung über mehr als eine App-Leiste verfügt. Wenn eine Anwendung mehr als eine App-Leiste enthält, verwenden Sie diese Eigenschaft, um Unterscheidungsnamen wie "Top" oder "Bottom" verfügbar zu machen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von App-Balkensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId |
Relevante Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die für die Steuerelemente, die den AppBar-Steuerelementtyp implementieren, aber nicht unbedingt erforderlich sind, besonders relevant sind.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ MenuClosedEventId | Plattformimplementierungen können dieses Ereignis ausgelöst, wenn das App-Balkensteuerelement geschlossen wird. |
| _UIA-MenüOpenedEventId | Plattformimplementierungen können dieses Ereignis beim Öffnen des App-Balkensteuerelements ausgelöst haben. |
| IUIAutomationPropertyChangedEventHandler | Eigenschaftenveränderte Ereignishandler. |