Typ kontrolki CheckBox
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla CheckBox typu kontrolki.
Pole wyboru to obiekt używany do wskazywania stanu, z którego użytkownicy mogą korzystać w celu przechodzenia przez ten stan. Pola wyboru przedstawiają użytkownikowi opcję binarną (Tak/Nie), (Włączone/Wyłączone) lub tertiary (Włączone, Wyłączone, Nieokreślone).
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla CheckBox typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek pól wyboru, 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
- DefaultAction
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolek pól wyboru 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 CheckBox 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 | CheckBox | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Wartość tej właściwości musi zawsze być true. Oznacza to, że kontrolka pola wyboru musi być zawsze uwzględniona w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Wartość tej właściwości musi zawsze być true. Oznacza to, że kontrolka pola wyboru musi być zawsze uwzględniona 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 | Kontrolki pól wyboru są etykietami własnymi. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki CheckBox. Wartość domyślna to "pole wyboru" dla en-US lub angielskiego (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Wartość właściwości IUIAutomationElement::CurrentName (lub CachedName) to tekst wyświetlany obok pola, który utrzymuje stan przełącznika. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pól wyboru. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Notatki |
|---|---|---|
| IToggleProvider | Wymagane | Pola wyboru obsługują Przełącz wzorzec sterowania, aby umożliwić programowe cyklowanie pola wyboru przez jego stany wewnętrzne. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek pól wyboru. 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_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, 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_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId zdarzenie zmienione właściwości. |
DefaultAction
Domyślną akcją pola wyboru jest spowodowanie, że przycisk radiowy zostanie skoncentrowany i przełączenie jego bieżącego stanu. Jak wspomniano wcześniej, pola wyboru prezentują decyzję binarną (Tak/Nie lub Włączone/Wyłączone) dla użytkownika lub tertiary (On, Off, Indeterminate). Jeśli pole wyboru jest binarne, domyślna akcja powoduje, że stan "włączone" stanie się "wyłączony" lub stan "wyłączony" stanie się "włączony". W tertiary pole wyboru domyślne akcji przechodzi przez stany pola wyboru w takiej samej kolejności, jak w przypadku wysłania kolejnych kliknięć myszy do kontrolki.
Tematy pokrewne