AppBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des AppBar-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Eine App-Leiste ist ein Benutzeroberflächenelement, das dem Benutzer Navigation, Befehle und Tools darstellt. Bei Windows Store-Apps können App-Leisten für Apps durch Drücken der Windows-Taste +Z angezeigt werden.
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 der Struktur
- Relevante Eigenschaften
- Erforderliche Ereignisse
- Relevante Ereignisse
- Zugehörige Themen
Typische Struktur der 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 am häufigsten verwendete 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 (Steuerelementtyp Trennzeichen ) verfügen, die in der Steuerelementansicht wie zwischen den anderen Steuerelementen platziert angezeigt werden. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Steuerelemente relevant ist, die den AppBar-Steuerelementtyp implementieren. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht 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-Leistensteuerelement ist nicht in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Ein App-Leiste-Steuerelement 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 haben. |
| 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-Leistensteuerelemente haben in der Regel keine Bezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem AppBar-Steuerelementtyp entspricht. Der Standardwert ist "App-Leiste" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das App-Leiste-Steuerelement benötigt keinen Namen, es sei denn, eine Anwendung verfügt über mehr als eine App-Leiste. Wenn in einer Anwendung mehr als eine App-Leiste vorhanden ist, verwenden Sie diese Eigenschaft, um Unterscheidungsnamen verfügbar zu machen, z. B. "Oben" oder "Unten". |
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.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. | 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 besonders für die Steuerelemente relevant sind, die den AppBar-Steuerelementtyp implementieren, aber nicht unbedingt erforderlich sind.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| UIA_MenuClosedEventId | Plattformimplementierungen können dieses Ereignis auslösen, wenn das App-Leiste-Steuerelement geschlossen wird. |
| UIA_MenuOpenedEventId | Plattformimplementierungen können dieses Ereignis auslösen, wenn das App-Leiste-Steuerelement geöffnet wird. |
| IUIAutomationPropertyChangedEventHandler | Ereignishandler mit geänderter Eigenschaft. |
Zugehörige Themen