Supporto di automazione interfaccia utente per il tipo di controllo DataGrid

Articolo
08/11/2011

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 Microsoft UI Automation per il tipo di controllo DataGrid. In UI Automation un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlType. Le condizioni includono linee guida specifiche per la struttura ad albero di UI Automation, i valori delle proprietà di UI Automation e i pattern di controllo.

Il tipo di controllo DataGrid consente di utilizzare facilmente gli elementi che contengono metadati rappresentati in colonne. I controlli griglia dei dati includono righe di elementi e colonne di informazioni relative a tali elementi. Un controllo Elenco in Esplora risorse di Microsoft Vista è un esempio che supporta il tipo di controllo DataGrid.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di UI Automation necessari per il tipo di controllo DataGrid. I requisiti di UI Automation si applicano a tutti i controlli griglia dei dati, sia Windows Presentation Foundation (WPF), Win32 che 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
Esempio di tipo di controllo DataGrid
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 griglia dei dati 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.

Struttura ad albero di UI Automation - Visualizzazione controlli	Struttura ad albero di UI Automation - Visualizzazione contenuto
DataGrid Header (0, 1 o 2) HeaderItem (numero di colonne o righe) DataItem (0 o più, può essere strutturato in una gerarchia)	DataGrid DataItem (0 o più, può essere strutturato in una gerarchia)

DataGrid

Header (0, 1 o 2)
- HeaderItem (numero di colonne o righe)
DataItem (0 o più, può essere strutturato in una gerarchia)

DataGrid

DataItem (0 o più, può essere strutturato in una gerarchia)

Proprietà di Automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà il cui valore o definizione è particolarmente rilevante per i controlli griglia dei dati. Per ulteriori informazioni sulle proprietà dell'UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà	Valore	Note
AutomationIdProperty	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Il rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty	Vedere le note.	Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.
ControlTypeProperty	DataGrid	Questo valore è identico per tutti i framework dell'interfaccia utente.
IsContentElementProperty	True	Il valore di questa proprietà deve essere sempre True. Questo significa che il controllo griglia dei dati deve sempre essere incluso nella visualizzazione contenuto della struttura ad albero di UI Automation.
IsControlElementProperty	True	Il valore di questa proprietà deve essere sempre True. Questo significa che il controllo griglia dei dati deve sempre essere incluso nella visualizzazione controlli della struttura ad albero di UI Automation.
IsKeyboardFocusableProperty	Vedere le note.	Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
LabeledByProperty	Vedere le note.	Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
LocalizedControlTypeProperty	"griglia dei dati"	Stringa localizzata che corrisponde al tipo di controllo DataGrid.
NameProperty	Vedere le note.	Il controllo griglia dei dati ottiene in genere il valore per la relativa proprietà Name da un'etichetta di testo statica. Se non è presente un'etichetta di testo statica, è necessario che lo sviluppatore dell'applicazione assegni un valore per la proprietà Name. Il valore della proprietà Name non deve essere mai il contenuto testuale del controllo di modifica.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo che devono essere supportati da tutti i controlli griglia dei dati. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo	Supporto	Note
IGridProvider	Sì	Il controllo griglia dati supporta sempre il pattern di controllo Grid perché gli elementi che contiene sono metadati disposti in una griglia.
IScrollProvider	A seconda dei casi	La possibilità di scorrere la griglia dei dati dipende dal contenuto e dalla presenza o meno di barre di scorrimento.
ISelectionProvider	A seconda dei casi	La possibilità di selezionare la griglia dati dipende dal contenuto.
ITableProvider	Sì	Il controllo griglia dei dati include sempre un'intestazione all'interno del relativo sottoalbero, quindi il pattern di controllo Table deve essere supportato.

Gli elementi dati all'interno dei contenitori griglia dati supporteranno almeno quanto segue:

Pattern di controllo Selection Item (se è possibile selezionare la griglia dati)
Pattern di controllo Scroll Item (se è possibile scorrere la griglia dati)
Pattern di controllo Grid Item
Pattern di controllo Table Item

Eventi di Automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di UI Automation che devono essere supportati da tutti i controlli griglia dei dati. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento UI Automation	Supporto	Note
AutomationFocusChangedEvent	Obbligatorio	Nessuno
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
LayoutInvalidatedEvent	A seconda dei casi	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno
Evento di proprietà modificata CurrentViewProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata HorizontallyScrollableProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
Evento di proprietà modificata HorizontalScrollPercentProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
Evento di proprietà modificata HorizontalViewSizeProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticalScrollPercentProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticallyScrollableProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticalViewSizeProperty.	A seconda dei casi	Se il controllo supporta il modello Scroll, deve supportare questo evento.
InvalidatedEvent	Obbligatorio	Nessuno

Esempio di tipo di controllo DataGrid

Nell'immagine seguente è illustrato un controllo Elenco che implementa il tipo di controllo DataGrid.

Grafica di controllo ListView con due elementi di dati

Di seguito sono riportate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di UI Automation relativamente al controllo Elenco. I pattern di controllo per ogni elemento di automazione sono indicati tra parentesi.

Struttura ad albero di UI Automation - Visualizzazione controlli	Struttura ad albero di UI Automation - Visualizzazione contenuto
DataGrid (Table, Grid, Selection) Header HeaderItem "Name" (Invoke) HeaderItem "Date Modified" (Invoke) HeaderItem "Size" (Invoke) Group "Contoso" (TableItem, GridItem, SelectionItem, Table, Grid) DataItem "Accounts Receivable.doc" (SelectionItem, Invoke, TableItem, GridItem) DataItem "Accounts Payable.doc" (SelectionItem, Invoke, TableItem, GridItem)	DataGrid (Table, Grid, Selection) Group "Contoso" (TableItem, GridItem, SelectionItem, Table, Grid) DataItem "Accounts Receivable.doc" (SelectionItem, Invoke, TableItem, GridItem) DataItem "Accounts Payable.doc" (SelectionItem, Invoke, TableItem, GridItem)

* Nell'esempio precedente viene illustrato un controllo DataGrid che contiene più livelli di controlli. Il controllo Group ("Contoso") contiene due controlli DataItem ("Accounts Receivable.doc" e "Accounts Payable.doc"). Una coppia DataGrid/GridItem è indipendente da una coppia a un altro livello. I controlli DataItem in un controllo Group possono essere esposti anche come tipo di controllo ListItem, per poter essere presentati più chiaramente come oggetti selezionabili, anziché come semplici elementi di dati. In questo esempio non sono inclusi i sottoelementi degli elementi di dati raggruppati.