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 Albero. 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 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 Microsoft Windows Explorer. 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 dell'automazione dell'interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo dell'Albero. I requisiti di automazione interfaccia utente si applicano a tutti i controlli albero, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione dei controlli e la visualizzazione del contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli albero e descrive cosa può essere contenuto in ogni visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
Albero
|
Albero
|
La visualizzazione dei controlli dell'albero di automazione interfaccia utente è costituita da:
Da zero a molti elementi all'interno del contenitore (possono essere basati sull'elemento Tree, sull'elemento di dati o su un altro tipo di controllo).
Zero, una o due barre 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 sull'elemento albero, sull'elemento di dati o su un altro tipo di controllo).
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. | I controlli albero hanno un punto cliccabile che farà sì che l'albero o uno degli elementi nel contenitore dell'albero ottenga il focus. Si ottiene un punto selezionabile per un albero solo se è possibile fare clic in un punto che non causa l'selezione o l'attivazione di uno degli elementi. |
| ControlTypeProperty | Albero | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo albero è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo albero è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| LabeledByProperty | Vedere le note. | Se al controllo albero è associata un'etichetta, questa proprietà restituirà un oggetto AutomationElement per tale etichetta. In caso contrario, la proprietà restituirà un riferimento Null (Nothing in Microsoft Visual Basic .NET). |
| LocalizedControlTypeProperty | "albero" | Stringa localizzata corrispondente al tipo di controllo List. |
| NameProperty | 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, lo sviluppatore dell'applicazione deve fornire un valore per questa proprietà. |
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 |
|---|---|---|
| ISelectionProvider | Dipende da | I controlli albero che contengono 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 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. |
| IScrollProvider | Dipende da | Implementare questo pattern di controllo se è possibile scorrere il contenuto del contenitore ad albero. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli albero. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| InvalidatedEvent | Dipende da | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà HorizontallyScrollableProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà HorizontalScrollPercentProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà HorizontalViewSizeProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticalScrollPercentProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticallyScrollableProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticalViewSizeProperty. | Dipende da | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |