Tipo di controllo RadioButton

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo RadioButton.

Un pulsante di opzione è composto da un pulsante circolare e testo definito dall'applicazione (etichetta), un'icona o una bitmap che indica una scelta che l'utente può effettuare selezionando il pulsante. Un'applicazione usa in genere i pulsanti di opzione in una casella di gruppo per consentire all'utente di effettuare la scelta da un set di opzioni correlate che si escludono a vicenda. Ad esempio, l'applicazione potrebbe visualizzare 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, a destra oppure 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 di un gruppo è il contenuto di un interruttore. Alcuni framework dell'interfaccia utente considerano un pulsante di opzione come pulsante di attivazione/disattivazione specializzato.

 

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo RadioButton. I requisiti Automazione interfaccia utente si applicano a tutti i controlli dei pulsanti in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli pulsante di opzione e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • RadioButton
  • RadioButton

 

Non sono presenti elementi figli nella visualizzazione controlli o nella visualizzazione contenuto.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo RadioButton ,ad esempio i controlli pulsante. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il 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 TRUE Il controllo pulsante di opzione è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo pulsante di opzione è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId NULL I controlli pulsante di opzione vengono etichettati automaticamente 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.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo 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.

Pattern di controllo/proprietà del pattern Supporto/valore Note
ISelectionItemProvider Necessario 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 Automazione interfaccia utente possa determinare quali altri pulsanti di opzione all'interno di un contesto specifico si riferiscono 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 Dopo aver impostato questa proprietà, il pulsante di opzione non può scorrere tra i propri stati. Il pattern di controllo Attiva/Disattiva non deve mai essere supportato su un pulsante di opzione.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli pulsante. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della 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

 

Commenti

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 interattivo, ad esempio il pulsante.

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente