Supporto per automazione interfaccia utente del tipo di controllo Group

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Group. 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 di automazione interfaccia utente.

Il controllo gruppo rappresenta un nodo all'interno di una gerarchia. Con il tipo di controllo Group viene creata una separazione nella struttura ad albero di automazione interfaccia utente affinché gli elementi raggruppati siano divisi logicamente all'interno della struttura ad albero di automazione interfaccia utente.

Nelle sezioni riportate di seguito 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 Group. I requisiti di automazione interfaccia utente si applicano a tutti i controlli gruppo, Windows Presentation Foundation (WPF), Win32 o Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente obbligatoria
  • Proprietà di automazione interfaccia utente obbligatorie
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • 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 gruppo 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

  • Group

    • 0 o molti controlli

  • Group

    • 0 o molti controlli

I controlli gruppo in genere presentano i tipi di controllo Supporto per automazione interfaccia utente del tipo di controllo ListItem, Supporto per automazione interfaccia utente del tipo di controllo TreeItem o Supporto per automazione interfaccia utente del tipo di controllo DataItem sotto di essi nella sottostruttura. Poiché 'Group' è un contenitore generico, è possibile inserire qualsiasi tipo di controllo sotto il controllo Group nella struttura ad albero.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella riportata di seguito sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli gruppo. 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.

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.

IsKeyboardFocusableProperty

Vedere le note.

Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.

NameProperty

Vedere le note.

Il controllo gruppo ottiene in genere il nome dal testo che etichetta il controllo.

LabeledByProperty

Vedere le note.

I controlli gruppo sono in genere controlli con etichetta automatica. In questi casi restituire null qui. Se è presente un'etichetta di testo statica per il gruppo, è necessario che venga restituita come valore della proprietà LabeledBy.

ControlTypeProperty

Group

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

LocalizedControlTypeProperty

"gruppo"

Stringa localizzata che corrisponde al tipo di controllo Group.

IsContentElementProperty

True

Il controllo gruppo è sempre incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.

IsControlElementProperty

True

Il gruppo calendario è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati per il tipo di controllo Group. 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

IExpandCollapseProvider

A seconda dei casi

I controlli gruppo che è possibile utilizzare per visualizzare o nascondere informazioni devono supportare il pattern Expand Collapse.

Eventi di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli gruppo. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Note

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata ExpandCollapseStateProperty.

A seconda dei casi

Nessuno

Evento di proprietà modificata ToggleStateProperty.

A seconda dei casi

Nessuno

AutomationFocusChangedEvent

Obbligatorio

Nessuno

StructureChangedEvent

Obbligatorio

Nessuno

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

Group