Tipo di controllo albero
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
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
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 |
|---|---|
|
|
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 |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per