RadioButton, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla RadioButton typu sterowania.
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.
Nuta
Kolejną uogólnioną kontrolką przycisków, w których można wybrać tylko jedną grupę, jest zawartość przycisku przełącznika. Niektóre struktury interfejsu użytkownika uważają przycisk radiowy za wyspecjalizowany przycisk przełącznika.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla RadioButton typu. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek przycisków, 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
- uwagi
- 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 radiowych 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 |
|---|---|
|
|
W widoku kontrolki ani w widoku zawartości nie ma żadnych elementów podrzędnych.
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 kontrolek, które implementują RadioButton typ kontrolki (na przykład kontrolki przycisków). 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. | Punkt klikalny musi być punktem, który po kliknięciu wybiera przycisk radiowy. |
| UIA_ControlTypePropertyId | RadioButton | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka przycisku radiowego jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka przycisku radiowego jest zawsze uwzględniana w widoku sterowania 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 przycisku radiowego są oznaczone etykietą własną zawartością. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki RadioButton. Wartość domyślna to "przycisk radiowy" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki przycisku radiowego to tekst wyświetlany obok przycisku, który utrzymuje stan zaznaczenia. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek przycisków radiowych. 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 |
|---|---|---|
| ISelectionItemProvider | Wymagane | Wszystkie kontrolki przycisków radiowych muszą obsługiwać wzorzec sterowania SelectionItem, aby umożliwić wybór siebie. |
| SelectionContainer | Zobacz uwagi. | Właściwość SelectionContainer musi być zawsze ukończona, aby klient automatyzacji interfejsu użytkownika mógł określić, jakie inne przyciski radiowe w określonym kontekście odnoszą się do siebie. W przypadku przycisku radiowego Microsoft Win32 ta właściwość nie jest obsługiwana, ponieważ nie można uzyskać tych informacji ze starszej wersji platformy. |
| IToggleProvider | Nigdy | Przycisk radiowy nie może przechodzić przez jego stan po ustawieniu. Wzorzec sterowania przełącznika nigdy nie może być obsługiwany na przycisku radiowym. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek przycisków. 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_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_SelectionItem_ElementRemovedFromSelectionEventId | Jeśli kontrolka obsługuje wzorzec kontrolki SelectionItem, musi obsługiwać to zdarzenie. |
| UIA_SelectionItem_ElementSelectedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki SelectionItem, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Uwagi
Przycisk radiowy reprezentuje jedną opcję do wyboru wśród grupy przycisków radiowych elementu równorzędnego. W idealnym przypadku przyciski radiowe powinny mieć element grupowania, który wyjaśnia granice przycisków radiowych elementu równorzędnego. Często jednak granica jest implikowany przez strukturę elementu interfejsu użytkownika. Na przykład menu może zawierać zestaw kolejnych przycisków radiowych zamiast elementów menu lub zestaw przycisków radiowych, które występują po etykiecie grupy, ale przed elementem z możliwością działania, takim jak przycisk.
Tematy pokrewne