Supporto di automazione interfaccia utente per il tipo di controllo RadioButton

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo RadioButton. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo.

Un pulsante di opzione è costituito da un pulsante rotondo e da un testo definito dall'applicazione (etichetta), un'icona o una bitmap che indica una scelta che l'utente può effettuare selezionando il pulsante. Un'applicazione utilizza in genere i pulsanti di opzione in una casella di gruppo per permettere all'utente di scegliere tra un insieme di opzioni correlate ma mutuamente esclusive. Ad esempio, l'applicazione potrebbe presentare un gruppo di pulsanti di opzione dal quale l'utente può selezionare una preferenza di formato per il testo selezionato nell'area client. L'utente può selezionare un formato di testo allineato a sinistra, allineato a destra o centrato selezionando il pulsante di opzione corrispondente. In genere, l'utente può selezionare solo un'opzione alla volta da un insieme di pulsanti di opzione.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo RadioButton. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elenco, sia Windows Presentation Foundation (WPF)Win32 che Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente obbligatoria
  • Proprietà di automazione interfaccia utente obbligatorie
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli pulsante di opzione e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli

Visualizzazione contenuto

  • RadioButton

  • RadioButton

Nella visualizzazione controlli o nella visualizzazione contenuto non sono presenti elementi figlio.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo RadioButton. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente

Valore

Note

AutomationIdProperty()

Vedere le note.

Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.

BoundingRectangleProperty

Vedere le note.

Il rettangolo più esterno che contiene l'intero controllo.

IsKeyboardFocusableProperty

Vedere le note.

Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.

NameProperty

Vedere le note.

Il nome del controllo pulsante di opzione corrisponde al testo visualizzato accanto al pulsante che mantiene lo stato di selezione.

ClickablePointProperty

Vedere le note.

Il punto selezionabile del controllo pulsante di opzione DEVE essere un punto che imposta la selezione sul pulsante di opzione se viene selezionato con un clic del mouse.

LabeledByProperty

Null

I pulsanti di opzione sono controlli con etichetta automatica.

ControlTypeProperty

RadioButton

Questo valore è identico per tutti i framework dell'interfaccia utente.

LocalizedControlTypeProperty

"pulsante di opzione"

Stringa localizzata che corrisponde al tipo di controllo RadioButton.

IsContentElementProperty

True

Il controllo pulsante di opzione è sempre incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.

IsControlElementProperty

True

Il controllo pulsante di opzione è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati da tutti i controlli pulsante di opzione. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern di controllo

Supporto/Valore

Note

ISelectionItemProvider

Tutti i controlli pulsante di opzione devono supportare il modello Selection Item per poter essere selezionati.

SelectionContainer

Vedere le note.

La proprietà SelectionContainerProperty deve essere sempre completata affinché un client di automazione interfaccia utente possa determinare quali altri pulsanti di opzione all'interno di un contesto specifico sono correlati gli uni agli altri. Per la versione Win32 del pulsante di opzione, questa proprietà non sarà supportata perché non è possibile ottenere questa informazione da questo framework legacy.

IToggleProvider

Mai

Una volta impostato, lo stato del pulsante di opzione non può essere cambiato ciclicamente. Questo modello non deve essere mai supportato sul pulsante di opzione.

Eventi di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli pulsante di opzione. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Note

ElementRemovedFromSelectionEvent

Obbligatorio

Nessuna

ElementSelectedEvent

Obbligatorio

Nessuna

Evento di proprietà modificata ToggleStateProperty.

Mai

Nessuna

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuna

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuna

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuna

AutomationFocusChangedEvent

Obbligatorio

Nessuna

StructureChangedEvent

Obbligatorio

Nessuna

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

RadioButton