Condividi tramite

Tipo di controllo albero

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Albero.

Il tipo di controllo Albero viene usato per i contenitori il cui contenuto ha rilevanza come gerarchia di nodi, come nel modo in cui vengono visualizzati i file e le cartelle nel riquadro sinistro di Esplora risorse. Ciascun nodo può potenzialmente contenere altri nodi, denominati nodi figlio. I nodi padre, ovvero i nodi contenenti nodi figlio, possono essere visualizzati in formato espanso o compresso. Il controllo visualizzazione albero di Windows (identificato da WC_TREEVIEW) è un esempio di un controllo appartenente al tipo di controllo Albero .

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 Albero. I requisiti Automazione interfaccia utente si applicano a tutti i controlli dell'elemento ad albero 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

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli albero 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
  • Albero
    • DataItem (0 o più)
    • TreeItem (0 o più)
      • TreeItem (0 o più)
        • ...
    • ScrollBar (0, 1, 2)
  • Albero
    • DataItem (0 o più)
    • TreeItem (0 o più)
      • TreeItem (0 o più)
        • ...

 

La visualizzazione del controllo dell'albero Automazione interfaccia utente è costituita da:

  • Zero di molti elementi all'interno del contenitore (gli elementi possono essere basati sui tipi di controllo TreeItem o DataItem ).
  • Zero, uno o due controlli barra di scorrimento

La visualizzazione contenuto dell'albero Automazione interfaccia utente è costituita da zero o molti elementi all'interno del contenitore (gli elementi possono essere basati sui tipi di controllo TreeItem o DataItem).

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo Albero. 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. I controlli albero hanno un punto selezionabile che causa la ricezione dello stato attivo dell'albero o di uno degli elementi nel contenitore albero. Un controllo albero può avere un punto selezionabile solo se è possibile fare clic su una posizione nell'albero senza causare l'selezione di un elemento o la ricezione dello stato attivo.
UIA_ControlTypePropertyId Albero Questo valore è uguale per tutti i framework dell'interfaccia utente.
UIA_IsContentElementPropertyId TRUE Il controllo albero è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo albero è 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. Se il controllo albero ha un'etichetta associata a essa, questa proprietà restituisce un puntatore IUIAutomationElement per tale etichetta. In caso contrario, la proprietà restituisce un riferimento Null.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Albero . Il valore predefinito è "albero" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il valore della proprietà name di un controllo struttura in genere deriva dal testo dell'etichetta del controllo. Se non è presente alcuna etichetta di testo, è necessario specificare un valore per questa proprietà.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati da tutti i controlli albero. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IScrollProvider Dipende da Implementare il modello di controllo Scroll se è possibile scorrere gli elementi nel contenitore albero.
ISelectionProvider Dipende da I controlli albero che contengono un set di elementi selezionabili devono implementare il modello di controllo Selezione . Non è necessario implementare se la selezione di un elemento non trasmette informazioni significative all'utente.
CanSelectMultiple Vedere le note. Implementare questa proprietà se il controllo struttura supporta la selezione multipla (la maggior parte dei controlli struttura non supporta la selezione multipla).
IsSelectionRequired Vedere le note. Il valore di questa proprietà viene esposta quando il controllo richiede la selezione di un elemento.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che tutti i controlli albero devono 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_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_ScrollHorizontallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_Selection_InvalidatedEventId Se il controllo supporta il modello di controllo Selection , 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