Supporto di automazione interfaccia utente per il tipo di controllo RadioButton
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 |