Supporto per automazione interfaccia utente del tipo di controllo TreeItem

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo TreeItem. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Tali condizioni includono linee guida specifiche per la struttura ad albero dell'automazione interfaccia utente, i valori di proprietà dell'automazione interfaccia utente e i pattern di controllo.

Il tipo di controllo TreeItem rappresenta un nodo all'interno di un contenitore struttura ad albero. Ogni nodo potrebbe contenere altri nodi, denominati nodi figlio. I nodi padre, ovvero i nodi che contengono nodi figlio, possono essere visualizzati in forma espansa o compressa.

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 TreeItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elemento albero, 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 elemento albero 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

  • TreeItem

    • CheckBox (0 o 1)

    • Image (0 o 1)

    • Button (0 o 1)

    • TreeItem (0 o più)

  • TreeItem

    • TreeItem (0 o più)

I controlli elemento albero possono avere zero o più elementi figlio nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente. Se il controllo elemento albero offre funzionalità aggiuntive rispetto a quanto esposto nei pattern di controllo elencati di seguito, è necessario che si basi sul tipo di controllo DataItem.

Gli elementi albero compressi non compaiono nella visualizzazione controlli o contenuto finché non vengono espansi o non diventano visibili, ovvero finché non è possibile scorrerli nella visualizzazione.

Gli elementi albero che vengono fatti scorrere all'esterno dello schermo sono presenti in entrambe le visualizzazioni controlli e contenuto della struttura ad albero di automazione interfaccia utente e il relativo campo IsOffscreenProperty deve essere impostato su True.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli elenco. Per ulteriori informazioni sulle proprietà dell'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.

Questa proprietà deve restituire il percorso dell'elemento che causa il cambiamento dello stato di selezione o il passaggio allo stato attivo di un elemento.

ControlTypeProperty

TreeItem

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

IsContentElementProperty

True

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

IsControlElementProperty

True

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

IsOffscreenProperty

Vedere le note.

Questa proprietà viene impostata per indicare quando un controllo elemento albero viene fatto scorrere all'esterno dello schermo.

IsKeyboardFocusableProperty

Vedere le note.

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

ItemTypeProperty

Vedere le note.

Se il controllo elemento albero utilizza un'icona visiva per indicare che si tratta di un determinato tipo di oggetto, questa proprietà deve essere supportata e deve indicare di quale oggetto si tratta.

LabeledByProperty

Null

I controlli elemento albero sono controlli con etichetta automatica.

LocalizedControlTypeProperty

"elemento albero"

Stringa localizzata che corrisponde al tipo di controllo TreeItem.

NameProperty

Vedere le note.

Questa proprietà espone il testo visualizzato per ogni controllo elemento albero.

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 dai controlli elenco. 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

IInvokeProvider

A seconda dei casi

Implementare questo pattern di controllo se l'elemento albero dispone di un comando azionabile separato.

IExpandCollapseProvider

Tutti gli elementi albero possono essere espansi o compressi.

ExpandCollapseState

Espanso, compresso o nodo foglia

Gli elementi albero sono nodi foglia quando non sono né espansi né compressi.

IScrollItemProvider

A seconda dei casi

Implementare questo pattern di controllo se il contenitore albero supporta il pattern di controllo Scroll.

ISelectionItemProvider

A seconda dei casi

Implementare questo pattern di controllo se è possibile avere una selezione attiva che viene mantenuta quando l'utente torna al contenitore albero.

SelectionContainer

Questa proprietà espone lo stesso contenitore per tutti gli elementi all'interno del contenitore.

IToggleProvider

A seconda dei casi

Implementare questo pattern di controllo se l'elemento della struttura ad albero contiene una casella di controllo associata.

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 elemento albero. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Note

AutomationFocusChangedEvent

Obbligatorio

None

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

None

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

None

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

None

Evento di proprietà modificata ItemStatusProperty.

A seconda dei casi

None

Evento di proprietà modificata NameProperty.

Obbligatorio

None

StructureChangedEvent

Obbligatorio

None

Evento di proprietà modificata ExpandCollapseStateProperty.

Obbligatorio

None

InvokedEvent

A seconda dei casi

None

Evento di proprietà modificata CurrentViewProperty.

A seconda dei casi

None

ElementAddedToSelectionEvent

A seconda dei casi

None

ElementRemovedFromSelectionEvent

A seconda dei casi

None

ElementSelectedEvent

A seconda dei casi

None

Evento di proprietà modificata ToggleStateProperty.

A seconda dei casi

None

Evento di proprietà modificata ValueProperty.

A seconda dei casi

None

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

TreeItem