Supporto di automazione interfaccia utente per il tipo di controllo CheckBox

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di 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 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.

Una casella di controllo è un oggetto utilizzato per indicare uno stato con cui gli utenti possono interagire per cambiarlo ciclicamente. Le caselle di controllo presentano all'utente un'opzione binaria (Sì/No), (Attivato/Disattivato) o terziaria (Attivato, Disattivato, Non definito).

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 CheckBox. I requisiti di automazione interfaccia utente si applicano a tutti i controlli casella di controllo, 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
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • Azione predefinita
  • 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 casella di controllo 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

  • CheckBox

  • CheckBox

Nota:

Le caselle di controllo non includono mai elementi figlio nella visualizzazione controlli o contenuto. Se il controllo deve contenere elementi figlio, significa che è necessario utilizzare un altro tipo di controllo.

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 i controlli casella di controllo. 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.

ClickablePointProperty

Vedere le note.

Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.

ControlTypeProperty

CheckBox

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

IsContentElementProperty

True

Il valore di questa proprietà deve essere sempre True. Questo significa che il controllo casella di controllo deve sempre essere incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.

IsControlElementProperty

True

Il valore di questa proprietà deve essere sempre True. Questo significa che il controllo casella di controllo deve sempre essere incluso nella visualizzazione controlli della struttura ad 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

"casella di controllo"

Stringa localizzata che corrisponde 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 di attivazione/disattivazione.

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 casella di controllo. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern

Supporto/Valore

Note

IToggleProvider

Obbligatorio

Consente di cambiare ciclicamente gli stati interni della casella di controllo a livello di codice.

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 casella di controllo. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Note

AutomationFocusChangedEvent

Obbligatorio

Nessuna

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuna

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuna

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuna

StructureChangedEvent

Obbligatorio

Nessuna

Evento di proprietà modificata ToggleStateProperty.

Obbligatorio

Nessuna

Azione predefinita

L'azione predefinita della casella di controllo è di spostare lo stato attivo su un pulsante di opzione e attivarne/disattivarne lo stato corrente. Come accennato in precedenza, le caselle di controllo presentano all'utente un'opzione binaria (Sì/No) (Attivato/Disattivato) o terziaria (Attivato, Disattivato, Non definito). Se la casella di controllo è binaria, con l'azione predefinita lo stato "attivato" diventa "disattivato" o viceversa. In una casella di controllo terziaria con l'azione predefinita gli stati vengono cambiati ciclicamente nell'ordine che si otterrebbe se l'utente inviasse al controllo una serie di clic successivi con il mouse.

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

CheckBox