Tipo di controllo gruppo

  • Articolo

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

Un controllo gruppo rappresenta un nodo all'interno di una gerarchia. Il tipo di controllo Group crea una separazione nell'albero Automazione interfaccia utente in modo che gli elementi raggruppati abbiano una divisione logica all'interno dell'albero Automazione interfaccia utente.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo Group. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli di gruppo in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli di gruppo e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Gruppo
    • 0 o molti controlli
  • Gruppo
    • 0 o molti controlli

 

I controlli di gruppo includono in genere Automazione interfaccia utente supporto per i tipi di controllo trovati di seguito nel sottoalbero, inclusi i tipi di controllo ListItem, TreeItem e DataItem. Poiché un controllo gruppo è un contenitore generico, è possibile che qualsiasi tipo di controllo si trova sotto il controllo gruppo nell'albero.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di gruppo. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di 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 tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue hit testing specializzati, esegue l'override e fornisce un punto selezionabile.
UIA_ControlTypePropertyId Gruppo
UIA_IsContentElementPropertyId TRUE Il controllo gruppo viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo gruppo è sempre 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 Vedere le note. I controlli gruppo sono in genere associati a un'etichetta automatica. In questi casi, restituire NULL. Se il gruppo ha un'etichetta di testo statica, restituire l'etichetta come valore della proprietà LabeledBy .
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Group . Il valore predefinito è "group" per en-US o english (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo gruppo in genere ricava il proprio nome dal testo dell'etichetta applicata al controllo.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per essere supportati per il tipo di controllo Group. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto Note
IExpandCollapseProvider Dipende da I controlli di gruppo che possono essere utilizzati per visualizzare o nascondere le informazioni devono supportare il pattern di controllo ExpandCollapse .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli di gruppo. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_ExpandCollapseExpandCollapseStatePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo ExpandCollapse , deve supportare questo evento.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_ToggleToggleStatePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Toggle , deve supportare questo evento.
UIA_StructureChangedEventId

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente