StatusBar, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla StatusBar typu kontrolki.
Kontrolka paska stanu wyświetla informacje o obiekcie wyświetlanym w oknie aplikacji, składniku obiektu lub informacji kontekstowych odnoszących się do operacji tego obiektu w aplikacji.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla StatusBar typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek paska stanu, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- uwagi
- 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 paska stanu i opisano, co można zawierać w każdym widoku. 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 paska stanu. 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. | Prostokąt ograniczenia paska stanu musi obejmować wszystkie zawarte w nim kontrolki. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli istnieją obszary w prostokątze ograniczenia, które nie są klikalne, a element wykonuje wyspecjalizowane testowanie trafień, przesłoń to i zapewni punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | StatusBar | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka paska stanu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka paska stanu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zależy | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_IsOffscreenPropertyId | Zależy | Jeśli kontrolka paska stanu nie jest obecnie widoczna, zwróci wartość TRUE dla tej właściwości. |
| UIA_LabeledByPropertyId | ZERO | Kontrolka paska stanu zwykle nie ma etykiety. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki StatusBar. Wartość domyślna to "pasek stanu" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka paska stanu nie wymaga nazwy, chyba że w aplikacji jest używana więcej niż jedna. W takim przypadku należy odróżnić każdy pasek z nazwami, takimi jak "Stan Internetu" lub "Stan aplikacji". |
| UIA_OrientationPropertyId | Zależy | Wartość wskazująca orientację kontrolki: poziomą lub pionową. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek paska stanu. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IGridProvider | Fakultatywny | Kontrolki paska stanu powinny obsługiwać wzorzec sterowania siatki, dzięki czemu poszczególne elementy można monitorować i łatwo odwoływać się do informacji. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek paska stanu. 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 |
Uwagi
Zalecamy używanie kontrolek edycji jako elementów siatki podrzędnej na pasku stanu. Użycie kontrolek edycji ułatwia skojarzenie przeznaczenia pola stanu z jego wartością przy użyciu nazwy elementu i właściwości value. Ponieważ kontrolki tekstu nie powinny obsługiwać wzorca kontrolki Value, nie powinny być używane jako elementy siatki podrzędnej.
Tematy pokrewne