Condividi tramite

Supporto automazione interfaccia utente per il tipo di controllo CheckBox

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 di Automazione interfaccia utente Microsoft per il tipo di controllo CheckBox. 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.

Una casella di controllo è un oggetto utilizzato per indicare uno stato con cui gli utenti possono interagire per scorrere tale stato. Le caselle di controllo presentano un'opzione binaria (Sì/No), (On/Off) o terziaria (On, Off, Indeterminate) all'utente.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo CheckBox. I requisiti di automazione UI si applicano a tutti i controlli delle caselle di controllo, sia che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente mostra la vista di controllo e la vista del contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli delle caselle di controllo e descrive ciò che può essere contenuto in ciascuna vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
CheckBox CheckBox

Annotazioni

Le caselle di controllo non includono mai elementi figlio nel controllo o nella visualizzazione contenuto. Se il controllo deve contenere elementi figlio, questo indica che deve essere utilizzato un tipo diverso di controllo.

Proprietà di automazione interfaccia utente necessarie

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 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.
ClickablePointProperty Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile.
ControlTypeProperty CheckBox Questo valore è lo stesso 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 della tastiera, deve supportare questa proprietà.
LabeledByProperty Null Le caselle di controllo sono controlli auto-etichettanti.
LocalizedControlTypeProperty "casella di controllo" Stringa localizzata corrispondente al tipo di controllo CheckBox.
NameProperty Vedere le note. Il valore della proprietà del controllo Name casella di controllo è il testo visualizzato accanto alla casella che mantiene lo stato di attivazione/disattivazione.

Modelli di controllo di automazione interfaccia utente necessari

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per 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 Assistenza Note
IToggleProvider Obbligatorio Consente di scorrere gli stati interni della casella di controllo a livello di codice.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli casella di controllo. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di automazione interfaccia utente Assistenza Note
AutomationFocusChangedEvent Obbligatorio Nessuno
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno
Evento di cambiamento della proprietà ToggleStateProperty. Obbligatorio Nessuno

Azione predefinita

L'azione predefinita della casella di controllo consiste nell'attivare e attivare o disattivare lo stato corrente di un pulsante di opzione. Come accennato in precedenza, le caselle di controllo presentano una decisione binaria (Sì/No) (Attivo/Disattivo) per l'utente o una decisione ternaria (Attivo, Disattivo, Indeterminato). Se la casella di controllo è binaria, l'azione predefinita fa sì che lo stato "on" diventi "off" o lo stato "off" diventi "on". In una casella di controllo in stato terziario il ciclo di azione predefinito attraversa gli stati nello stesso ordine in cui l'utente avesse inviato successivi clic del mouse sul controllo.

Vedere anche