Obsługa automatyzacji interfejsu użytkownika dla typu formantu RadioButton
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 dla typu kontrolki RadioButton. 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.
Przycisk radiowy składa się z przycisku okrągłego i tekstu zdefiniowanego przez aplikację (etykiety), ikony lub mapy bitowej wskazującej wybór, który użytkownik może dokonać, wybierając przycisk. Aplikacja zazwyczaj używa przycisków radiowych w polu grupy, aby zezwolić użytkownikowi na wybór spośród zestawu powiązanych, ale wzajemnie wykluczających się opcji. Na przykład aplikacja może przedstawiać grupę przycisków radiowych, z których użytkownik może wybrać preferencję formatowania tekstu wybranego w obszarze klienta. Użytkownik może wybrać wyrównany do lewej, wyrównany do prawej lub wyśrodkowany format, wybierając odpowiedni przycisk radiowy. Zazwyczaj użytkownik może wybrać tylko jedną opcję naraz z zestawu przycisków radiowych.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki RadioButton. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek listy, 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 przycisków radiowych 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 |
|---|---|
| RadioButton | RadioButton |
W widoku kontrolki ani w widoku zawartości nie ma żadnych elementów podrzędnych.
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 typu kontrolki RadioButton. 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ę. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Nazwa kontrolki przycisku radiowego to tekst wyświetlany obok przycisku, który utrzymuje stan zaznaczenia. |
| ClickablePointProperty | Zobacz uwagi. | Punkt klikalny kontrolki przycisku radiowego MUSI być punktem ustawiania zaznaczenia przycisku radiowego po kliknięciu wskaźnika myszy. |
| LabeledByProperty | Null |
Przyciski radiowe to kontrolki samodzielnego etykietowania. |
| ControlTypeProperty | RadioButton | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "przycisk radiowy" | Zlokalizowany ciąg odpowiadający typowi kontrolki RadioButton. |
| IsContentElementProperty | Prawda | Kontrolka przycisku radiowego jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka przycisku radiowego jest zawsze uwzględniana w widoku sterowania drzewa automatyzacja interfejsu użytkownika. |
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 przycisków radiowych. 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/wzorzec kontrolki | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| ISelectionItemProvider | Tak | Wszystkie kontrolki przycisków radiowych muszą obsługiwać wzorzec elementu zaznaczenia, aby umożliwić sobie wybranie. |
| SelectionContainer | Zobacz uwagi. | Należy SelectionContainerProperty zawsze wykonać element , aby klient automatyzacja interfejsu użytkownika mógł określić, jakie inne przyciski radiowe w określonym kontekście odnoszą się do siebie nawzajem. W przypadku przycisku radiowego Win32 ta właściwość nie będzie obsługiwana, ponieważ nie można uzyskać tych informacji ze starszej platformy. |
| IToggleProvider | Nigdy | Przycisk radiowy nie może przechodzić przez jego stan po ustawieniu. Ten wzorzec nigdy nie może być obsługiwany na przycisku radiowym. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki przycisków radiowych. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| ElementRemovedFromSelectionEvent | Wymagania | Brak |
| ElementSelectedEvent | Wymagania | Brak |
| ToggleStateProperty zdarzenie zmienione właściwości. | Nigdy | 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 |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |