Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu CheckBox
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
Ten temat zawiera informacje o obsłudze automatyzacja interfejsu użytkownika firmy Microsoft dla typu formantu CheckBox. W automatyzacja interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka ControlTypeProperty w celu użycia właściwości . Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości i wzorce kontrolek.
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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki CheckBox. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek pól wyboru, niezależnie od tego, czy Windows Presentation Foundation (WPF), Win32 lub Windows Forms.
Wymagana struktura drzewa automatyzacja interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacja interfejsu użytkownika odnoszącego się do kontrolek pól wyboru i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
| CheckBox | CheckBox |
Uwaga
Pola wyboru nigdy nie mają elementów podrzędnych w kontrolce lub widoku zawartości. Jeśli kontrolka musi zawierać elementy podrzędne, oznacza to, że należy użyć innego typu kontrolki.
Wymagane właściwości automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono właściwości automatyzacja interfejsu użytkownika, których wartość lub definicja jest szczególnie istotne dla kontrolek pól wyboru. Aby uzyskać więcej informacji na temat właściwości automatyzacja interfejsu użytkownika, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
| właściwość automatyzacja interfejsu użytkownika | Wartość | Uwagi |
|---|---|---|
| AutomationIdProperty | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| BoundingRectangleProperty | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| ControlTypeProperty | CheckBox | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| IsContentElementProperty | Prawda | Wartość tej właściwości musi zawsze mieć wartość True. Oznacza to, że kontrolka pola wyboru musi być zawsze uwzględniona w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Wartość tej właściwości musi zawsze mieć wartość True. Oznacza to, że kontrolka pola wyboru musi być zawsze uwzględniona w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| LabeledByProperty | Null |
Pola wyboru to kontrolki samodzielnego etykietowania. |
| LocalizedControlTypeProperty | "pole wyboru" | Zlokalizowany ciąg odpowiadający typowi kontrolki CheckBox. |
| NameProperty | Zobacz uwagi. | Wartość właściwości kontrolki Name pola wyboru to tekst wyświetlany obok pola, które utrzymuje stan przełącznika. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pól wyboru. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz automatyzacja interfejsu użytkownika Control Patterns Overview (Omówienie wzorców kontrolek automatyzacja interfejsu użytkownika).
| Wzorzec kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| IToggleProvider | Wymagania | Umożliwia programowe przechodzenie przez wewnętrzne stany pola wyboru. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pól wyboru. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| AutomationFocusChangedEvent | Wymagania | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
| ToggleStateProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
Akcja domyślna
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 przedstawiają decyzję binarną (Tak/Nie) (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 stanie tertiary pole wyboru domyślne akcji przechodzi przez stany pola wyboru w takiej samej kolejności, jak w przypadku wysłania kolejnych kliknięć myszą do kontrolki.