Condividi tramite

Tipo di controllo CheckBox

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo CheckBox.

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 di automazione interfaccia utente, le proprietà, i pattern 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 o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.

Questo argomento contiene le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo tipico e una visualizzazione contenuto dell'albero di automazione interfaccia utente relativo ai controlli casella di controllo e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • CheckBox
  • CheckBox

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo checkBox. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.

Ui Automation, proprietà 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 di automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile.
UIA_ControlTypePropertyId checkBox
UIA_IsContentElementPropertyId 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.
UIA_IsControlElementPropertyId 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.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
UIA_LabeledByPropertyId Nullo 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) è il testo visualizzato accanto alla casella che mantiene lo stato di attivazione/disattivazione.

 

Modelli di controllo obbligatori

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.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo/pattern, proprietà Supporto/valore Note
IToggleProvider Obbligatorio Le caselle di controllo supportano il Attiva/Disattiva pattern di controllo per consentire il ciclo della casella di controllo a livello di codice attraverso i relativi stati interni.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli casella di controllo. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà.
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento.
UIA_IsEnabledPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId evento di modifica delle proprietà.

 

DefaultAction

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 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 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 in cui l'utente aveva inviato clic del mouse successivi al controllo.

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente