Condividi tramite

Tipo di controllo albero

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft 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 i file e le cartelle vengono visualizzati nel riquadro sinistro di Esplora risorse. Ogni nodo può contenere altri nodi, denominati nodi figlio. I nodi padre o i nodi che contengono nodi figlio possono essere visualizzati come espansi o compressi. Il controllo visualizzazione albero di Windows , come identificato da WC_TREEVIEW, è un esempio di un controllo che appartiene al tipo di controllo albero.

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 albero. I requisiti di automazione interfaccia utente si applicano a tutti i controlli degli elementi ad albero 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 e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente relativi ai controlli albero 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
  • 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 dei controlli dell'albero di 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 di automazione interfaccia utente è costituita da zero o molti elementi all'interno del contenitore ( gli elementi possono essere basati sul TreeItem o tipi di controllo DataItem).

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo albero. 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. I controlli albero hanno un punto selezionabile che fa sì che l'albero o uno degli elementi nel contenitore albero ricevano lo stato attivo. Un controllo albero può avere un punto selezionabile solo se è possibile fare clic su una posizione nell'albero senza che venga selezionato un elemento o ricevere lo stato attivo.
UIA_ControlTypePropertyId albero Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
UIA_IsContentElementPropertyId VERO Il controllo albero è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo albero è 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 Vedere le note. Se al controllo albero è associata un'etichetta, questa proprietà restituisce un IUIAutomationElement puntatore 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 albero deriva in genere dal testo che etichetta il controllo. Se non è presente alcuna etichetta di testo, è necessario specificare un valore per questa proprietà.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di 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.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo/pattern, proprietà Supporto/valore Note
IScrollProvider Dipende Implementare il pattern di controllo Scorrimento se è possibile scorrere gli elementi nel contenitore dell'albero.
ISelectionProvider Dipende I controlli albero che contengono un set di elementi selezionabili devono implementare il pattern di controllo selezione. Non è necessario implementarla se la selezione di un elemento non fornisce informazioni significative all'utente.
CanSelectMultiple Vedere le note. Implementare questa proprietà se il controllo albero supporta la selezione multipla (la maggior parte dei controlli albero non supporta la selezione multipla).
IsSelectionRequired Vedere le note. Il valore di questa proprietà viene esposto se il controllo richiede che sia selezionato un elemento.

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente che tutti i controlli albero devono supportare. 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_IsEnabledPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento.
UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_Selection_InvalidatedEventId Se il controllo supporta il pattern di controllo Selection, deve supportare questo evento.
UIA_StructureChangedEventId

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente