Supporto per automazione interfaccia utente del tipo di controllo Tree
.gif "Nota") Nota |
|---|
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese). |
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Tree. In UI Automation un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di UI Automation, i valori delle proprietà UI Automation e i pattern di controllo.
Il tipo di controllo dell'Albero è utilizzato per contenitori il cui contenuto ha attinenza come una gerarchia di nodi, fin da con la modalità file e cartelle sono visualizzate nel riquadro sinistro di Microsoft Windows Explorer. Ogni nodo può contenere altri nodi, denominati nodi figlio. I nodi padre, ovvero i nodi che contengono nodi figlio, possono essere visualizzati in forma espansa o compressa.
Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di UI Automation necessari per il tipo di controllo Tree. I requisiti di UI Automation si applicano a tutti i controlli struttura ad albero, Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Nel presente argomento sono contenute le seguenti sezioni.
- Struttura ad albero di automazione interfaccia utente obbligatoria
- Proprietà di Automazione interfaccia utente obbligatorie
- Pattern di controllo di automazione interfaccia utente obbligatori
- Eventi di automazione interfaccia utente obbligatori
- Argomenti correlati
Struttura ad albero di automazione interfaccia utente obbligatoria
Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di UI Automation relativamente ai controlli struttura ad albero e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.
Visualizzazione controlli |
Visualizzazione contenuto |
|---|---|
Struttura ad albero
|
Struttura ad albero
|
La visualizzazione controlli della struttura ad albero UI Automation contiene:
Da zero a molti elementi all'interno del contenitore (gli elementi possono essere basati su TreeItem, DataItem o altri tipi di controllo).
Zero, uno o due barre di scorrimento.
La visualizzazione contenuto della struttura ad albero di UI Automation è costituita da zero o molti elementi all'interno del contenitore (gli elementi possono essere basati su TreeItem, DataItem o altri tipi di controllo).
Proprietà di Automazione interfaccia utente obbligatorie
Nella tabella seguente sono elencate le proprietà di UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli elenco. Per ulteriori informazioni sulle proprietà dell'oggetto UI Automation, vedere Proprietà di automazione interfaccia utente per i client.
Proprietà di UI Automation |
Valore |
Note |
|---|---|---|
Vedere le note. |
Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione. |
|
Vedere le note. |
Rettangolo più esterno che contiene l'intero controllo. |
|
Vedere le note. |
I controlli struttura ad albero dispongono di un punto selezionabile che, quando viene selezionato, causa l'impostazione dello stato attivo sulla struttura ad albero o su uno degli elementi del contenitore albero. È possibile ottenere un punto selezionabile per una struttura ad albero solo se si fa clic in un punto che non causa la selezione o l'impostazione dello stato attivo per uno degli elementi. |
|
Struttura ad albero |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
True |
Il controllo struttura ad albero è sempre incluso nella visualizzazione contenuto della struttura ad albero di UI Automation. |
|
True |
Il controllo struttura ad albero è sempre incluso nella visualizzazione controlli della struttura ad albero di UI Automation. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
Vedere le note. |
Se il controllo struttura ad albero è associato a 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). |
|
"struttura ad albero" |
Stringa localizzata che corrisponde al tipo di controllo List. |
|
Vedere le note. |
Il valore della proprietà Name di un controllo struttura ad albero deriva di solito dal testo dell'etichetta del controllo. Se non è presente un'etichetta di testo, lo sviluppatore di applicazioni deve fornire un valore per questa proprietà. |
Pattern di controllo di automazione interfaccia utente obbligatori
Nella tabella riportata di seguito sono elencati i pattern di controllo di UI Automation che devono essere supportati dai controlli elenco. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.
Pattern di controllo/Proprietà pattern |
Supporto/Valore |
Note |
|---|---|---|
A seconda dei casi |
I controlli struttura ad albero che contengono un insieme di elementi selezionabili devono implementare questo pattern di controllo. Non è necessario implementare questo pattern di controllo se la selezione di un elemento non fornisce informazioni significative all'utente. |
|
Vedere le note. |
Implementare questa proprietà se il controllo struttura ad albero supporta la selezione multipla, funzionalità non supportata dalla maggior parte dei controlli struttura ad albero. |
|
Vedere le note. |
Il valore di questa proprietà viene esposto se il controllo richiede la selezione di un elemento. |
|
A seconda dei casi |
Implementare questo pattern di controllo se è possibile scorrere il contenuto di un contenitore struttura ad albero. |
Eventi di automazione interfaccia utente obbligatori
Nella tabella riportata di seguito sono elencati gli eventi di UI Automation che devono essere supportati da tutti i controlli struttura ad albero. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.
Evento UI Automation |
Supporto |
Note |
|---|---|---|
A seconda dei casi |
Nessuno |
|
Evento di proprietà modificata BoundingRectangleProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsOffscreenProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsEnabledProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata HorizontallyScrollableProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata HorizontalScrollPercentProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata HorizontalViewSizeProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata VerticalScrollPercentProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata VerticallyScrollableProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata VerticalViewSizeProperty. |
A seconda dei casi |
Nessuno |
Obbligatorio |
Nessuno |
|
Obbligatorio |
Nessuno |
Vedere anche
Riferimenti
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente