Supporto di automazione interfaccia utente per il tipo di controllo CheckBox
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente Microsoft per il tipo di controllo CheckBox. In Automazione interfaccia utente, 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 Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
Una casella di controllo è un oggetto usato per indicare uno stato con cui gli utenti possono interagire per scorrere tale stato. Le caselle di controllo presentano all'utente un'opzione binaria (Yes/No), (On/Off) o terziaria (On, Off, Indeterminate).
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo CheckBox. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della casella di controllo, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli casella di controllo e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| CheckBox | CheckBox |
Nota
Le caselle di controllo non hanno mai elementi figlio nella visualizzazione controlli o contenuti. Se non è necessario che il controllo contenga elementi figlio, significa che è opportuno usare un altro tipo di controllo.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli casella di controllo. Per maggiori 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 in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| ControlTypeProperty | CheckBox | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il valore di questa proprietà deve essere sempre True. Ciò significa che il controllo casella di controllo deve essere sempre incluso nella visualizzazione contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il valore di questa proprietà deve essere sempre True. Ciò significa che il controllo casella di controllo deve essere sempre incluso nella visualizzazione controllo dell'albero di Automazione interfaccia utente. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| LabeledByProperty | Null |
Le caselle di controllo sono controlli con etichetta automatica. |
| LocalizedControlTypeProperty | "check box" | Stringa localizzata corrispondente al tipo di controllo CheckBox. |
| NameProperty | Vedere le note. | Il valore della proprietà Name del controllo casella di controllo è il testo visualizzato accanto alla casella che mantiene lo stato attivo/non attivo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati da tutti i controlli casella di controllo. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IToggleProvider | Richiesto | Consente di scorre gli stati interni della casella di controllo a livello di codice. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli casella di controllo. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| AutomationFocusChangedEvent | Richiesto | 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 |
| StructureChangedEvent | Richiesto | None |
| Evento di modifica della proprietàToggleStateProperty . | Richiesto | None |
Azione predefinita
L'azione predefinita della casella di controllo è fare sì che un pulsante di opzione assuma lo stato attivo e attivarne/disattivarne lo stato corrente. Come accennato in precedenza, le caselle di controllo presentano all'utente una decisione binaria (Yes/No), (On/Off) o terziaria (On, Off, Indeterminate). Se la casella di controllo è binaria, l'azione predefinita fa sì che lo stato "on" diventi "off" o che lo stato "off" diventi "on". In una casella di controllo con stato terziario l'azione predefinita scorre gli stati della casella di controllo nello stesso ordine con cui li scorrerebbe se l'utente avesse inviato al controllo una serie di clic del mouse in successione.