SplitButton, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla SplitButton typu kontrolki.
Kontrolka przycisku podziału umożliwia wykonanie akcji na kontrolce i rozwinięcie kontrolki w celu wyświetlenia listy innych możliwych akcji, które można wykonać.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla SplitButton typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek przycisków podzielonych, 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
- przykładowy typ kontrolki splitButton
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika, który odnosi się do kontrolek przycisków podzielonych i opisuje, 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 istotne dla SplitButton 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 | SplitButton | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| UIA_HelpTextPropertyId | Zobacz uwagi. | Tekst pomocy może wskazywać wynik aktywowania przycisku podziału, który jest zazwyczaj tego samego typu informacjami przedstawionymi za pomocą etykietki narzędzia. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka przycisku podziału zawiera informacje dla użytkownika końcowego. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka przycisku podziału jest widoczna dla użytkownika końcowego. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | ZERO | Kontrolki przycisku podziału nie mają statycznej etykiety tekstowej. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki SplitButton. Wartość domyślna to "przycisk podziału" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Tekst używany do etykietowania przycisku podziału. Za każdym razem, gdy obraz jest używany do etykietowania przycisku podziału, dla właściwości Name przycisku podziału należy podać tekst alternatywny. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek przycisków podziału. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IExpandCollapseProvider | Wymagane | Ponieważ przyciski podziału zawsze mają możliwość rozwinięcia listy opcji, muszą obsługiwać wzorzec sterowania ExpandCollapse. |
| IInvokeProvider | Wymagane | Ponieważ przyciski podziału zawsze mają domyślną akcję skojarzą z metodą IInvokeProvider::Invoke, muszą obsługiwać wzorzec kontrolki Invoke. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek przycisku podziału. 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. | |
| UIA_Invoke_InvokedEventId | |
| 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 |
Przykład typu kontrolki SplitButton
Na poniższej ilustracji przedstawiono kontrolkę, która implementuje SplitButton typu kontrolki.
| Drzewo automatyzacji interfejsu użytkownika — widok sterowania | Drzewo automatyzacji interfejsu użytkownika — widok zawartości |
|---|---|
|
|
Tematy pokrewne