Supporto per automazione interfaccia utente del tipo di controllo TreeItem
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 TreeItem. 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 TreeItem rappresenta un nodo all'interno di un contenitore dell'albero. Ciascun nodo può 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 previsti per il tipo di controllo TreeItem. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli elemento 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 elemento 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 |
|---|---|
| TreeItem - CheckBox (0 o 1) - Immagine (0 o 1) - Pulsante (0 o 1) - TreeItem (0 o più) |
TreeItem - TreeItem (0 o più) |
I controlli elemento albero possono avere zero o più elementi figlio dell'albero nella vista contenuto dell'albero di Automazione interfaccia utente. Se il controllo TreeItem ha altre funzionalità oltre a quelle esposte nei pattern di controllo elencati di seguito, il controllo deve basarsi sul tipo di controllo DataItem.
Gli elementi compressi dell'albero vengono visualizzati nella visualizzazione contenuto o visualizzazione controlli solo dopo essere stati espansi e resi visibili oppure visualizzati mediante lo scorrimento.
La visualizzazione controlli può contenere dettagli aggiuntivi per un controllo, tra cui un'immagine associata o un pulsante. Ad esempio, un elemento in una visualizzazione Struttura potrebbe contenere un'immagine e un pulsante per espandere o comprimere la struttura. Questi oggetti dettagliati non vengono visualizzati nella visualizzazione contenuto perché le informazioni sono già rappresentate dall'elemento padre dell'albero. Gli elementi albero che vengono fatti scorrere fuori dalla schermata verranno visualizzati sia nella vista controllo che nella vista contenuto dell'albero di Automazione interfaccia utente e devono avere il IsOffscreenProperty impostato su True.
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. | Questa proprietà deve restituire il percorso dell'elemento che causa la modifica dello stato di selezione dell'elemento oppure ne determina lo stato attivo. |
| ControlTypeProperty | TreeItem | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo elenco è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo elenco è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| IsOffscreenProperty | Vedere le note. | Questa proprietà è impostata per indicare quando un controllo TreeItem viene escluso dalla visualizzazione mediante lo scorrimento. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| ItemTypeProperty | Vedere le note. | Se il controllo TreeItem usa un'icona per indicare che si tratta di un particolare tipo di oggetto, questa proprietà deve essere supportata e indicare il tipo di oggetto. |
| LabeledByProperty | Null |
Per i controlli TreeItem l'etichetta viene definita automaticamente. |
| LocalizedControlTypeProperty | "tree item" | Stringa localizzata corrispondente al tipo di controllo TreeItem. |
| NameProperty | Vedere le note. | Questa proprietà espone il testo visualizzato per ogni controllo TreeItem. |
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 |
|---|---|---|
| IInvokeProvider | Dipende da | Implementare questo pattern di controllo se il controllo TreeItem dispone di un comando separato su cui è possibile eseguire azioni. |
| IExpandCollapseProvider | Sì | Tutti i controlli TreeItem possono essere espansi o compressi. |
| ExpandCollapseState | Espanso, compresso o nodo foglia | I controlli TreeItem saranno nodi foglia quando non sono espansi o compressi. |
| IScrollItemProvider | Dipende da | Implementare questo pattern di controllo se il contenitore dell'albero supporta il pattern di controllo Scroll. |
| ISelectionItemProvider | Dipende da | Implementare questo pattern di controllo se è possibile disporre di una selezione attiva che viene mantenuta quando l'utente torna al contenitore dell'albero. |
| SelectionContainer | Sì | Questa proprietà espone lo stesso contenitore per tutti gli elementi all'interno del contenitore. |
| IToggleProvider | Dipende da | Implementare questo pattern di controllo se il controllo TreeItem è associato a una casella di controllo. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli elemento albero. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| AutomationFocusChangedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàItemStatusProperty . | Dipende da | None |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| StructureChangedEvent | Richiesto | None |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Richiesto | None |
| InvokedEvent | Dipende da | None |
| Evento di modifica della proprietàCurrentViewProperty . | Dipende da | None |
| ElementAddedToSelectionEvent | Dipende da | None |
| ElementRemovedFromSelectionEvent | Dipende da | None |
| ElementSelectedEvent | Dipende da | None |
| Evento di modifica della proprietàToggleStateProperty . | Dipende da | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |