Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu CheckBox

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki CheckBox. W Automatyzacji interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka, aby korzystać z właściwości ControlTypeProperty. Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców 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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki CheckBox. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok 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 sterowania Widok zawartości
Pole wyboru Pole wyboru

Uwaga / Notatka

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 rodzaju kontrolki.

Wymagane właściwości automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono właściwości automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Właściwość automatyzacji interfejsu użytkownika Wartość Notatki
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ącie ograniczającym jest klikalny i wykonujesz wyspecjalizowane testowanie trafień, zapewnij punkt, który jest możliwy do kliknięcia.
ControlTypeProperty Pole wyboru 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 automatyzacji 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 automatyzacji 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 automatyzacji interfejsu użytkownika

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 elementów sterujących, zajrzyj do Omówienie wzorców automatyzacji interfejsu użytkownika.

Wzorzec kontrolki Wsparcie Notatki
IToggleProvider Wymagane Umożliwia programowe przechodzenie przez wewnętrzne stany pola wyboru.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji 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ń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
AutomationFocusChangedEvent Wymagane Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
StructureChangedEvent Wymagane Żaden
ToggleStateProperty zdarzenie zmiany właściwości. Wymagane Żaden

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ą decyzje binarne (Tak/Nie) (Włączone/Wyłączone) dla użytkownika albo decyzje trójstanowe (Włączone, Wyłączone, Niezdecydowane). 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 trzeciorzędowym stanie pole wyboru domyślna czynność przechodzi przez stany pole wyboru w takiej samej kolejności, jak w przypadku wysłania kolejnych kliknięć myszą do kontrolki.

Zobacz także

  • Last updated on