Tipo di controllo RadioButton
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo radiobutton.
Un pulsante di opzione è costituito da un pulsante rotondo e un testo definito dall'applicazione (un'etichetta), un'icona o una bitmap che indica una scelta che l'utente può effettuare selezionando il pulsante. Un'applicazione usa in genere pulsanti di opzione in una casella di gruppo per consentire all'utente di scegliere tra un set di opzioni correlate, ma che si escludono a vicenda. Ad esempio, l'applicazione potrebbe presentare un gruppo di pulsanti di opzione da cui l'utente può selezionare una preferenza di formato per il testo selezionato nell'area client. L'utente può selezionare un formato allineato a sinistra, allineato a destra o centrato selezionando il pulsante di opzione corrispondente. In genere, l'utente può selezionare una sola opzione alla volta da un set di pulsanti di opzione.
Nota
Un'altra generalizzazione dei controlli per i pulsanti in cui è possibile selezionare solo uno in un gruppo è il contenuto di un interruttore. Alcuni framework dell'interfaccia utente considerano un pulsante di opzione un interruttore specializzato.
Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo RadioButton. I requisiti di automazione interfaccia utente si applicano a tutti i controlli pulsante in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- osservazioni
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli dei pulsanti di opzione e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Non sono presenti elementi figlio nella visualizzazione controlli o nella visualizzazione contenuto.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli che implementano il radioButton tipo di controllo ,ad esempio i controlli pulsante. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Il punto selezionabile deve essere un punto che, quando si fa clic, seleziona il pulsante di opzione. |
| UIA_ControlTypePropertyId | radiobutton | |
| UIA_IsContentElementPropertyId | VERO | Il controllo pulsante di opzione è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo pulsante di opzione è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | NULLO | I controlli pulsante di opzione sono auto-etichettati in base al contenuto. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo radiobutton. Il valore predefinito è "pulsante di opzione" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il nome del controllo pulsante di opzione è il testo visualizzato accanto al pulsante che mantiene lo stato di selezione. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli pulsante di opzione. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo/pattern, proprietà | Supporto/valore | Note |
|---|---|---|
| ISelectionItemProvider | Obbligatorio | Tutti i controlli dei pulsanti di opzione devono supportare il pattern di controllo SelectionItem per poter essere selezionati. |
| SelectionContainer | Vedere le note. | La proprietà SelectionContainer deve essere sempre completata in modo che un client di automazione interfaccia utente possa determinare quali altri pulsanti di opzione all'interno di un contesto specifico sono correlati l'uno all'altro. Per la versione Microsoft Win32 del pulsante di opzione, questa proprietà non è supportata perché non è possibile ottenere queste informazioni da tale framework legacy. |
| IToggleProvider | Mai | Il pulsante di opzione non può scorrere lo stato dopo che è stato impostato. Il Attiva/Disattiva pattern di controllo non deve mai essere supportato su un pulsante di opzione. |
Eventi obbligatori
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli pulsante. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Se il controllo supporta il pattern di controllo SelectionItem, deve supportare questo evento. |
| UIA_SelectionItem_ElementSelectedEventId | Se il controllo supporta il pattern di controllo SelectionItem, deve supportare questo evento. |
| UIA_StructureChangedEventId |
Osservazioni
Un pulsante di opzione rappresenta una singola opzione selezionabile tra un gruppo di pulsanti di opzione peer. Idealmente, i pulsanti di opzione devono avere un elemento di raggruppamento che chiarisce i limiti dei pulsanti di opzione peer. Spesso, tuttavia, il limite è implicito dalla struttura degli elementi dell'interfaccia utente. Ad esempio, un menu può contenere un set di pulsanti di opzione consecutivi anziché voci di menu o un set di pulsanti di opzione che si verificano dopo un'etichetta di gruppo, ma prima di un elemento praticabile, ad esempio il pulsante.
Argomenti correlati