Supporto per automazione interfaccia utente del tipo di controllo Tree
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Tree. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter 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 criteri di controllo.
Il tipo di controllo albero viene utilizzato i per contenitori il cui contenuto ha rilevanza come gerarchia di nodi, come nel modo in cui file e cartelle vengono visualizzati nel riquadro sinistro di Microsoft Windows Explorer. 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.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo Tree. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli albero, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli albero e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
Albero
|
Albero
|
La vista controllo dell'albero di Automazione interfaccia utente è costituita da:
Elementi con relazione nessuno-a-molti all'interno del contenitore (gli elementi possono basarsi sul tipo di controllo TreeItem, DataItem o altri tipi di controllo).
Zero, uno o due barre di scorrimento.
La vista contenuto dell'albero di Automazione interfaccia utente è costituita da zero o più elementi all'interno del contenitore (gli elementi possono essere basati sull'elemento Tree, sull'elemento Data o su un altro tipo di controllo).
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli elenco. Per altre 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 in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | I controlli Tree dispongono di un punto selezionabile che causa l'impostazione dello stato attivo sull'albero o su uno degli elementi nel contenitore della struttura. Si ottiene un punto selezionabile per una struttura ad albero solo se è possibile fare clic in un punto che non causa la selezione di uno degli elementi oppure lo spostamento dello stato attivo su di essi. |
| ControlTypeProperty | Albero | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo albero è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo albero è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| LabeledByProperty | Vedere le note. | Se il controllo struttura è associato a un'etichetta, questa proprietà restituirà AutomationElement per tale etichetta. In caso contrario, la proprietà restituirà un riferimento Null (Nothing in Microsoft Visual Basic .NET). |
| LocalizedControlTypeProperty | "tree" | Stringa localizzata corrispondente al tipo di controllo elenco. |
| NameProperty | 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, lo sviluppatore dell'applicazione deve fornire un valore per questa proprietà. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli elenco. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| ISelectionProvider | Dipende da | I controlli struttura contenenti un set di elementi selezionabili devono implementare questo pattern di controllo. Questo pattern di controllo non deve essere implementato se la selezione di un elemento non fornisce 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. |
| IScrollProvider | Dipende da | Implementare questo pattern di controllo se il contenitore della struttura può essere sottoposto a scorrimento. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli albero. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvalidatedEvent | Dipende da | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |