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 DataItem. In automazione interfaccia utente 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 automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo.
Una voce in un elenco Contatti, ad esempio, è un controllo elemento dati. Un controllo elemento dati contiene informazioni di interesse per un utente finale. È più complicato del semplice elemento elenco poiché contiene informazioni più dettagliate.
Nelle sezioni riportate di seguito 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 DataItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elemento dati, Windows Presentation Foundation (WPF), Win32 o 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
- Utilizzo di elementi dati in elenchi di grandi dimensioni
- Eventi di automazione interfaccia utente obbligatori
- Esempio del tipo di controllo DataItem
- 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 elemento 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 riportata di seguito sono elencate le proprietà il cui valore o la cui definizione è particolarmente rilevante per i controlli elemento dati. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
Proprietà |
Value |
Note |
|---|---|---|
AutomationIdProperty() |
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. |
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. |
|
DataItem |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
True |
Il controllo elemento dati deve essere sempre un contenuto. |
|
True |
Il controllo elemento dati deve essere sempre un controllo. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
Vedere le note. |
Se il controllo contiene uno stato aggiornato dinamicamente, è necessario che questa proprietà sia supportata in modo da consentire ai prodotti tecnologici di assistenza di ricevere aggiornamenti quando lo stato dell'elemento cambia. |
|
Vedere le note. |
Si tratta del valore della stringa che indica all'utente finale l'oggetto sottostante rappresentato dall'elemento, ad esempio "File multimediale" o "Contatto". |
|
Null |
I controlli elemento dati non dispongono di un'etichetta di testo statica. |
|
"elemento dati" |
Stringa localizzata che corrisponde al tipo di controllo DataItem. |
|
Vedere le note. |
Il controllo elemento dati contiene sempre un elemento di testo primario correlato all'identificatore semantico che un utente assocerebbe all'elemento. |
Pattern di controllo di automazione interfaccia utente obbligatori
Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente Microsoft che devono essere supportati da tutti i controlli elemento dati. 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 |
Se è possibile espandere o comprimere l'elemento dati per visualizzare e nascondere informazioni, è necessario il supporto del pattern Expand Collapse. |
|
A seconda dei casi |
Gli elementi dati supportano il pattern GridItme quando un insieme di elementi dati è disponibile in un contenitore in cui è possibile spostarsi elemento per elemento. |
|
A seconda dei casi |
Tutti gli elementi dati supportano la possibilità di scorrimento nella visualizzazione con il pattern ScrollItem quando il relativo contenitore dei dati ha più elementi adattabili allo schermo. |
|
Sì |
Tutti gli elementi dati devono supportare il pattern SelectionItem per indicare quando l'elemento è selezionato. |
|
A seconda dei casi |
Se l'elemento dati è contenuto in un tipo di controllo DataGrid, supporta questo pattern. |
|
A seconda dei casi |
Se l'elemento dati contiene uno stato che può essere alternato ciclicamente. |
|
A seconda dei casi |
Se il testo primario dell'elemento dati è modificabile il pattern Value deve essere supportato. |
Utilizzo di elementi dati in elenchi di grandi dimensioni
Gli elenchi di grandi dimensioni sono spesso virtualizzati nei framework dell'interfaccia utente per migliorare le prestazioni. Per questo motivo, un client di automazione interfaccia utente non può utilizzare la funzionalità di query di automazione interfaccia utente per cercare il contenuto dell'intera struttura ad albero come avviene per altri contenitori di elementi. È necessario che un client scorra la visualizzazione dell'elemento prima di accedere all'insieme completo di informazioni dell'elemento dati.
Quando si chiama SetFocus sull'elemento di automazione interfaccia utente per l'elemento dati, il case di Esplora risorse di Microsoft Windows viene restituito correttamente e causa l'impostazione dello stato attivo su Edit nella sottostruttura dell'elemento dati.
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 elemento dati. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.
Evento di automazione interfaccia utente |
Supporto |
Note |
|---|---|---|
Obbligatorio |
Nessuno |
|
Evento di proprietà modificata BoundingRectangleProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsEnabledProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsOffscreenProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata NameProperty. |
Obbligatorio |
Nessuno |
Obbligatorio |
Nessuno |
|
A seconda dei casi |
Nessuno |
|
Evento di proprietà modificata ExpandCollapseStateProperty. |
A seconda dei casi |
Nessuno |
Obbligatorio |
Nessuno |
|
Obbligatorio |
Nessuno |
|
Obbligatorio |
Nessuno |
|
Evento di proprietà modificata ToggleStateProperty. |
A seconda dei casi |
Nessuno |
Evento di proprietà modificata ValueProperty. |
A seconda dei casi |
Nessuno |
Esempio del tipo di controllo DataItem
Nell'immagine seguente viene illustrato un tipo di controllo DataItem in un controllo ListView.
.gif)
Di seguito sono riportate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente al controllo elemento dati. 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 |
|---|---|
DataItem (Sort, Table, Selection, Grid)
|
DataItem (Sort, Table, Selection, Grid)
|
Vedere anche
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Cenni preliminari su automazione interfaccia utente