Tipo di controllo CheckBox
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo CheckBox.
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 sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo CheckBox. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli della casella di controllo in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Defaultaction
- Argomenti correlati
Struttura ad albero tipica
Nella tabella seguente viene illustrata una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli della casella di controllo e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per il tipo di controllo CheckBox. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable. |
| UIA_ControlTypePropertyId | CheckBox | |
| UIA_IsContentElementPropertyId | TRUE | Il valore di questa proprietà deve sempre essere TRUE. Ciò significa che il controllo casella di controllo deve sempre essere incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il valore di questa proprietà deve sempre essere TRUE. Ciò significa che il controllo casella di controllo deve sempre essere incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | Null | I controlli casella di controllo sono auto-etichettatura. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo CheckBox . Il valore predefinito è "casella di controllo" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il valore della proprietà IUIAutomationElement::CurrentName (o CachedName) della casella di controllo è il testo visualizzato accanto alla casella che mantiene lo stato di attivazione. |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo 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/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| IToggleProvider | Necessario | Le caselle di controllo supportano il modello di controllo Disattiva per consentire il ciclo della casella di controllo a livello di codice tramite i relativi stati interni. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che i controlli casella di controllo sono necessari per supportare. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Automazione interfaccia utente evento | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| UIA_IsOffscreenPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_IsEnabledPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId evento modificato dalla proprietà. |
Defaultaction
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 una decisione binaria (Sì/No o On/Off) all'utente o a un terziario (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 terziaria il ciclo di azione predefinito passa attraverso gli stati della casella di controllo nello stesso ordine di se l'utente ha inviato clic successivi del mouse al controllo.
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente