Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo TreeItem. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.
Il tipo di controllo TreeItem rappresenta un nodo all'interno di un albero. 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.
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 TreeItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli degli elementi della struttura ad albero, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la vista di controllo e la vista del contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli degli elementi ad albero e descrive cosa può essere incluso in ogni vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | 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 visualizzazione contenuto dell'albero di automazione interfaccia utente. Se il controllo elemento della struttura ad albero dispone di funzionalità oltre a quanto esposto nei pattern di controllo elencati di seguito, il controllo deve essere basato sul tipo di controllo Elemento dati.
Gli elementi dell'albero collassati non verranno visualizzati nella vista di controllo o nella vista del contenuto fino a quando non siano espansi e visibili (oppure possono essere scorrere in vista).
La visualizzazione controllo può contenere dettagli aggiuntivi per un controllo, inclusa un'immagine associata o un pulsante. Ad esempio, un elemento in una visualizzazione struttura può contenere un'immagine e un pulsante per espandere o comprimere la struttura. Questi oggetti di dettaglio non vengono visualizzati nella visualizzazione del contenuto perché le informazioni sono già rappresentate dall'elemento albero padre. Gli elementi della struttura ad albero che scorrono fuori dallo schermo verranno visualizzati sia nel controllo che nelle visualizzazioni di contenuto dell'albero di Automazione Interfaccia Utente e devono avere il IsOffscreenProperty impostato su true.
Proprietà di automazione interfaccia utente necessarie
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.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Questa proprietà deve restituire la posizione dell'elemento che farà sì che l'elemento cambi lo stato di selezione o diventi focalizzato. |
| ControlTypeProperty | TreeItem | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo elenco è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo elenco è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| IsOffscreenProperty | Vedere le note. | Questa proprietà è impostata per indicare quando viene eseguito lo scorrimento di un controllo elemento della struttura ad albero dalla schermata. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| ItemTypeProperty | Vedere le note. | Se il controllo elemento della struttura ad albero utilizza un'icona visiva per indicare che è un particolare tipo di oggetto, questa proprietà deve essere supportata e indicare qual è l'oggetto. |
| LabeledByProperty | Null |
I controlli degli elementi ad albero sono auto-etichettatura. |
| LocalizedControlTypeProperty | "elemento albero" | Stringa localizzata corrispondente al tipo di controllo TreeItem. |
| NameProperty | Vedere le note. | Questa proprietà espone il testo visualizzato per ogni controllo elemento della struttura ad albero. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati dai controlli elenco. 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 |
|---|---|---|
| IInvokeProvider | Dipende da | Implementare questo pattern di controllo se l'elemento della struttura ad albero dispone di un comando interattivo separato. |
| IExpandCollapseProvider | Sì | Tutti gli elementi dell'albero possono essere espansi o compressi. |
| ExpandCollapseState | Nodo espanso, compresso o foglia | Gli elementi dell'albero saranno nodi foglia quando non vengono espansi o compressi. |
| IScrollItemProvider | Dipende da | Implementare questo pattern di controllo se il contenitore della struttura ad albero supporta il pattern di controllo Scroll. |
| ISelectionItemProvider | Dipende da | Implementare questo schema di controllo se è possibile disporre di una selezione attiva che viene mantenuta quando l'utente torna al contenitore ad albero. |
| SelectionContainer | Sì | La proprietà esporrà lo stesso contenitore per tutti gli elementi contenuti al suo interno. |
| IToggleProvider | Dipende da | Implementare questo pattern di controllo se l'elemento della struttura ad albero ha una casella di controllo associata. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli degli elementi dell'albero. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ItemStatusProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà NameProperty. | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ExpandCollapseStateProperty. | Obbligatorio | Nessuno |
| InvokedEvent | Dipende da | Nessuno |
| Evento di cambiamento della proprietà CurrentViewProperty. | Dipende da | Nessuno |
| ElementAddedToSelectionEvent | Dipende da | Nessuno |
| ElementRemovedFromSelectionEvent | Dipende da | Nessuno |
| ElementSelectedEvent | Dipende da | Nessuno |
| Evento di cambiamento della proprietà ToggleStateProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà ValueProperty. | Dipende da | Nessuno |