Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo RadioButton. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 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.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo RadioButton. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli elenco, sia che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione dei controlli e la visualizzazione dei contenuti dell'albero di automazione dell'interfaccia utente relativa ai controlli dei pulsanti di opzione, e descrive cosa può essere contenuto in ciascuna visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| RadioButton | RadioButton |
Non sono presenti elementi figlio nella visualizzazione controlli o nella visualizzazione contenuto.
Proprietà di automazione interfaccia utente necessarie
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo RadioButton. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il nome del controllo pulsante di opzione è il testo visualizzato accanto al pulsante che mantiene lo stato di selezione. |
| ClickablePointProperty | Vedere le note. | Il punto cliccabile del controllo pulsante di opzione DEVE essere un punto che, se cliccato con un puntatore del mouse, imposta la selezione sul pulsante di opzione. |
| LabeledByProperty | Null |
I pulsanti di opzione sono controlli che si etichettano automaticamente. |
| ControlTypeProperty | RadioButton | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "pulsante di opzione" | Stringa localizzata corrispondente al tipo di controllo 'Radio Button'. |
| IsContentElementProperty | Vero | Il controllo pulsante di opzione è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo pulsante di opzione è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
Modelli di controllo di automazione interfaccia utente necessari
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/Proprietà del pattern di controllo | Supporto/valore | Note |
|---|---|---|
| ISelectionItemProvider | Sì | Tutti i controlli dei pulsanti di scelta devono supportare il modello Elemento di selezione per poter essere selezionati. |
| SelectionContainer | Vedere le note. | Deve SelectionContainerProperty essere sempre completato in modo che un client di automazione dell'interfaccia utente possa determinare quali altri pulsanti di opzione all'interno di un contesto specifico siano correlati tra loro. Per la versione Win32 del pulsante di opzione, questa proprietà non sarà supportata perché non è possibile ottenere queste informazioni da quel framework legacy. |
| IToggleProvider | Mai | Il pulsante di opzione non può scorrere lo stato dopo che è stato impostato. Questo modello non deve mai essere supportato sul pulsante di opzione. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di UI Automation necessari affinché tutti i controlli radio button li supportino. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| ElementRemovedFromSelectionEvent | Obbligatorio | Nessuno |
| ElementSelectedEvent | Obbligatorio | Nessuno |
| ToggleStateProperty evento modifica-proprietà. | Mai | Nessuno |
| BoundingRectangleProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| IsOffscreenProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| IsEnabledProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |