Typ kontrolki AppBar
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki AppBar.
Pasek aplikacji to element interfejsu użytkownika, który przedstawia użytkownikowi nawigację, polecenia i narzędzia. W przypadku aplikacji ze Sklepu Windows paski aplikacji dla aplikacji mogą być wyświetlane przez naciśnięcie systemu Windows + Z.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki AppBar.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane zdarzenia
- istotne zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek AppBar i opisano, co można zawierać w każdym widoku. Button jest najbardziej typowym elementem w AppBar, ale inne kontrolki, które wywołują akcje dla aplikacji, są również możliwe. AppBar może mieć również 0 lub więcej separatorów (separator typu kontrolki), które są wyświetlane w widoku kontrolki, jak umieszczono między innymi kontrolkami. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek implementujących typ kontrolki AppBar. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Wartość uwidoczniona przez tę właściwość musi zawierać wszystkie zawarte w niej kontrolki. |
| UIA_ControlTypePropertyId | AppBar | |
| UIA_IsContentElementPropertyId | FAŁSZYWY | Kontrolka paska aplikacji nie jest uwzględniona w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka paska aplikacji jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. Kontrolki na pasku aplikacji zwykle mogą skupić się na klawiaturze. |
| UIA_IsOffscreenPropertyId | Zobacz uwagi. | Wartość tej właściwości zależy od tego, czy kontrolka jest widoczna na ekranie. |
| UIA_LabeledByPropertyId | Zero | Kontrolki paska aplikacji zwykle nie mają etykiety. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki AppBar. Wartość domyślna to "pasek aplikacji" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka paska aplikacji nie wymaga nazwy, chyba że aplikacja ma więcej niż jeden pasek aplikacji. Jeśli w aplikacji znajduje się więcej niż jeden pasek aplikacji, użyj tej właściwości, aby uwidocznić nazwy wyróżniające, takie jak "Top" lub "Bottom". |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek paska aplikacji. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Istotne zdarzenia
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są szczególnie istotne dla kontrolek, które implementują AppBar typu kontrolki, ale nie są ściśle wymagane.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_MenuClosedEventId | Implementacje platformy mogą wyzwalać to zdarzenie po zamknięciu kontrolki paska aplikacji. |
| UIA_MenuOpenedEventId | Implementacje platformy mogą wyzwalać to zdarzenie po otwarciu kontrolki paska aplikacji. |
| IUIAutomationPropertyChangedEventHandler | Procedura obsługi zdarzeń zmieniona przez właściwość. |
Tematy pokrewne
-
koncepcyjne
-
typy kontrolek automatyzacji interfejsu użytkownika — omówienie
-
referencyjne
-
kontrolki XAMLAppBar