Supporto di automazione interfaccia utente per il tipo di controllo RadioButton

  • Articolo

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

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

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.

Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i modelli di controllo e gli eventi di UI Automation previsti per il tipo di controllo RadioButton. I requisiti di UI Automation si applicano a tutti i controlli elenco, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero di automazione interfaccia utente obbligatoria

La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di UI Automation che riguarda i controlli pulsante di opzione e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.

Visualizzazione controlli Visualizzazione contenuto
RadioButton RadioButton

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

Proprietà di automazione interfaccia utente obbligatorie

La tabella seguente elenca le proprietà UI Automation il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo RadioButton. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.

Proprietà di automazione interfaccia utente Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli in 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 RadioButton è il testo visualizzato accanto al pulsante con lo stato di selezione.
ClickablePointProperty Vedere le note. Il punto selezionabile del pulsante di opzione DEVE essere un punto che imposta la selezione sul pulsante di opzione se viene selezionato con il puntatore del mouse.
LabeledByProperty Null I pulsanti di opzione sono controlli con etichetta automatica.
ControlTypeProperty RadioButton Questo valore è uguale per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty "radio button" Stringa localizzata corrispondente al tipo di controllo RadioButton.
IsContentElementProperty Vero Il controllo pulsante di opzione è sempre incluso nella vista contenuto dell'albero di UI Automation.
IsControlElementProperty Vero Il controllo pulsante di opzione è sempre incluso nella vista controllo dell'albero di UI Automation.

Pattern di controllo obbligatori per l'automazione interfaccia utente

La seguente tabella elenca i modelli di controllo di UI Automation che devono essere supportati dai controlli pulsante di opzione. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern di controllo Supporto/valore Note
ISelectionItemProvider Sì Tutti i controlli pulsante di opzione devono supportare il pattern SelectionItem per poter essere selezionati.
SelectionContainer Vedere le note. La proprietà SelectionContainerProperty deve sempre essere completata in modo da consentire a un client di automazione interfaccia utente di determinare quali altri pulsanti di opzione in un contesto specifico sono correlati tra loro. Per la versione Win32 del pulsante di opzione questa proprietà non sarà supportata perché non è possibile ottenere questa informazione da tale framework legacy.
IToggleProvider Mai Dopo aver impostato questa proprietà, il pulsante di opzione non può scorrere tra i propri stati. Questo pattern non deve essere mai supportato nel pulsante di opzione.

Eventi di automazione interfaccia utente obbligatori

La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli pulsante di opzione. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di UI Automation Supporto tecnico Note
ElementRemovedFromSelectionEvent Richiesto None
ElementSelectedEvent Richiesto None
Evento di modifica della proprietàToggleStateProperty . Mai None
Evento di modifica della proprietàBoundingRectangleProperty . Richiesto None
Evento di modifica della proprietàIsOffscreenProperty . Richiesto None
Evento di modifica della proprietàIsEnabledProperty . Richiesto None
AutomationFocusChangedEvent Richiesto None
StructureChangedEvent Richiesto None

Vedi anche