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.
Aggiornamento: novembre 2007
In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente Microsoft per il tipo di controllo DataGrid. In automazione interfaccia utente 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 automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente 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 automazione interfaccia utente necessari per il tipo di controllo DataGrid. I requisiti di automazione interfaccia utente si applicano a tutti i controlli griglia dei dati, sia Windows Presentation Foundation (WPF), Win32 che Windows Form.
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 automazione interfaccia utente relativamente ai controlli griglia dei dati e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.
Struttura ad albero di automazione interfaccia utente - Visualizzazione controlli |
Struttura ad albero di automazione interfaccia utente - Visualizzazione contenuto |
|---|---|
|
|
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à di automazione interfaccia utente, 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. |
Vedere le note. |
Il rettangolo più esterno che contiene l'intero controllo. |
|
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. |
|
DataGrid |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
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 automazione interfaccia utente. |
|
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 automazione interfaccia utente. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
Vedere le note. |
Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. |
|
"griglia dei dati" |
Stringa localizzata che corrisponde al tipo di controllo DataGrid. |
|
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.
Interfaccia del pattern di controllo |
Supporto/Valore |
Note |
|---|---|---|
Sì |
Il controllo griglia dei dati supporta sempre il pattern di controllo Grid perché gli elementi che contiene hanno metadati disposti in una griglia. |
|
A seconda dei casi |
La possibilità di scorrere la griglia dei dati dipende dal contenuto e dalla presenza o meno di barre di scorrimento. |
|
Sì |
Tutti i controlli griglia dei dati contengono elementi all'interno che sono selezionabili. |
|
Sì |
Il controllo griglia dei dati include sempre un'intestazione all'interno del relativo sottoalbero, quindi il pattern di controllo Table deve essere supportato. |
I controlli elemento dei dati all'interno dei contenitori griglia dei dati supporteranno almeno quanto segue:
Pattern di controllo Selection Item
Pattern di controllo Scroll Item (se il contenitore è scorrevole)
Gli elementi all'interno del contenitore di elementi dei dati supporteranno almeno quanto segue:
Pattern di controllo Grid Item
Pattern di controllo Table Item
Eventi di automazione interfaccia utente obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente 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 di automazione interfaccia utente |
Supporto/Valore |
Note |
|---|---|---|
Obbligatorio |
Nessuna |
|
Evento di proprietà modificata BoundingRectangleProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata IsEnabledProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata IsOffscreenProperty. |
Obbligatorio |
Nessuna |
A seconda dei casi |
Nessuna |
|
Obbligatorio |
Nessuna |
|
Evento di proprietà modificata CurrentViewProperty. |
A seconda dei casi |
Nessuna |
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. |
Obbligatorio |
Nessuna |
Esempio di tipo di controllo DataGrid
Nell'immagine seguente è illustrato un controllo Elenco che implementa il tipo di controllo DataGrid.
.gif)
Di seguito sono riportate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente al controllo Elenco. I pattern di controllo per ogni elemento di automazione sono indicati tra parentesi.
Struttura ad albero di automazione interfaccia utente - Visualizzazione controlli |
Struttura ad albero di automazione interfaccia utente - Visualizzazione contenuto |
|---|---|
DataGrid (Sort, Table, Selection, Grid)
|
DataGrid (Sort, Table, Selection, Grid)
|
L'elemento di automazione Data Item può avere i seguenti elementi figlio: Edit, Image e Text.
Vedere anche
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Cenni preliminari su automazione interfaccia utente