ToolBar, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla ToolBar typu kontrolki. Kontrolki paska narzędzi umożliwiają użytkownikom końcowym aktywowanie poleceń i narzędzi zawartych w aplikacji.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla ToolBar typu kontrolki. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek pasków narzędzi, 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
- 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 narzędzi 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 |
|---|---|
|
|
Kontrolka paska narzędzi może zawierać dowolny typ kontrolki w ramach jego poddrzewa. Najczęściej zawierają przyciski, pola kombi i przyciski podziału.
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 ToolBar typu kontrolki. 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. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | ToolBar | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka paska narzędzi jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka paska narzędzi 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ść. |
| UIA_LabeledByPropertyId | ZERO | Kontrolka paska narzędzi nigdy nie ma etykiety. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki ToolBar. Wartość domyślna to "pasek narzędzi" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zależy | Kontrolka paska narzędzi nie potrzebuje nazwy, chyba że w aplikacji jest używana więcej niż jedna. Jeśli istnieje więcej niż jedna, każda z nich musi mieć nazwę wyróżniającą (na przykład "Formatowanie" lub "Podkreślenie"). |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki paska narzędzi. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IDockProvider | Zależy | Jeśli pasek narzędzi można zadokować do różnych części ekranu, musi obsługiwać wzorzec sterowania Dock. |
| IExpandCollapseProvider | Zależy | Jeśli pasek narzędzi można rozwinąć i zwinąć, aby wyświetlić więcej elementów, musi obsługiwać wzorzec kontrolki ExpandCollapse. |
| ITransformProvider | Zależy | Jeśli pasek narzędzi można zmienić, obrócić lub przenieść, musi obsługiwać wzorzec kontrolki Przekształć. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek paska narzędzi. 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_ExpandCollapseExpandCollapseStatePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki ExpandCollapse, musi obsługiwać to zdarzenie. |
| 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 |
Tematy pokrewne