Tipo di controllo DataItem
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo DataItem.
Una voce in un elenco Contatti è un esempio di controllo elemento di dati. Un controllo elemento dati contiene informazioni di interesse per un utente finale. È più complicato rispetto all'elemento di elenco semplice perché contiene informazioni più complete.
Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo DataItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli degli elementi di dati in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- uso di DataItem in elenchi di grandi dimensioni
- eventi obbligatori
- esempio di tipo di controllo DataItem
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli degli elementi di dati e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Un elemento elemento di dati in una griglia di dati può ospitare un'ampia gamma di oggetti, tra cui un altro livello di elementi di dati o elementi della griglia specifici, ad esempio testo, immagini o controlli di modifica. Se l'elemento dell'elemento dati ha un ruolo oggetto specifico, l'elemento deve essere esposto come tipo di controllo specifico; Ad esempio, un ListItem tipo di controllo per un elemento di dati selezionabile nella griglia.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo DataItem. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile. |
| UIA_ControlTypePropertyId | DataItem | |
| UIA_IsContentElementPropertyId | VERO | Il controllo elemento di dati deve essere sempre contenuto. |
| UIA_IsControlElementPropertyId | VERO | Il controllo elemento di dati deve essere sempre un controllo . |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_ItemStatusPropertyId | Vedere le note. | Se il controllo contiene lo stato che viene aggiornato in modo dinamico, questa proprietà deve essere supportata in modo che una tecnologia assistive possa ricevere aggiornamenti quando lo stato dell'elemento cambia. |
| UIA_ItemTypePropertyId | Vedere le note. | Si tratta del valore stringa che comunica all'utente finale l'oggetto sottostante rappresentato dall'elemento. Gli esempi includono "File multimediale" e "Contatto". |
| UIA_LabeledByPropertyId | Nullo | I controlli elemento dati non hanno un'etichetta di testo statica. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo DataItem. Il valore predefinito è "elemento dati" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo elemento di dati contiene sempre un elemento di testo primario che l'utente riconosce come identificatore per l'elemento. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli degli elementi di dati. 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 | Appoggiare | Note |
|---|---|---|
| IExpandCollapseProvider | Dipende | Se l'elemento di dati può essere espanso o compresso per visualizzare e nascondere le informazioni, è necessario supportare il pattern di controllo ExpandCollapse. |
| IGridItemProvider | Dipende | Gli elementi di dati supporteranno il pattern di controllo GridItem quando una raccolta di elementi di dati è disponibile all'interno di un contenitore che può essere spostato nello spazio da elemento a elemento. |
| IScrollItemProvider | Dipende | Tutti gli elementi di dati supportano la possibilità di scorrere nella visualizzazione con il pattern di controllo ScrollItem quando il contenitore di dati include più elementi che possono essere inseriti sullo schermo. |
| ISelectionItemProvider | Dipende | La possibilità di selezionare gli elementi di dati dipende dal contenuto. |
| ITableItemProvider | Dipende | Se l'elemento di dati è contenuto all'interno di un DataGrid tipo di controllo con un elemento di intestazione, deve supportare il pattern di controllo TableItem. |
| IToggleProvider | Dipende | Se l'elemento di dati contiene uno stato che può essere scorrere, deve supportare il Attiva/Disattiva pattern di controllo. |
| IValueProvider | Dipende | Se il testo primario dell'elemento dati è modificabile, è necessario supportare il pattern di controllo valore. |
Utilizzo di DataItem in elenchi di grandi dimensioni
Poiché gli elenchi di grandi dimensioni sono spesso virtualizzati all'interno dei framework dell'interfaccia utente per facilitare le prestazioni, un client di automazione interfaccia utente non può usare la funzionalità di query di automazione interfaccia utente per cercare il contenuto dell'albero completo nello stesso modo in cui può essere usato in altri contenitori di elementi. Un client deve scorrere l'elemento nella visualizzazione (o espandere il controllo per visualizzare tutte le opzioni disponibili) prima di accedere al set completo di informazioni dall'elemento di dati.
Quando si chiama SetFocus sull'elemento di automazione interfaccia utente per l'elemento di dati, Esplora risorse di Microsoft Windows restituisce correttamente lo stato attivo e imposta lo stato attivo sul controllo Modifica all'interno del sottoalbero dell'elemento di dati.
Eventi obbligatori
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli degli elementi di dati. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento di modifica delle proprietà. | Se il controllo supporta il ExpandCollapse pattern di controllo, deve supportare questo evento. |
| UIA_Invoke_InvokedEventId | Se il controllo supporta il pattern di controllo Invoke, deve supportare questo evento. |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_ItemStatusPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàitemStatus, deve supportare questo evento. |
| UIA_NamePropertyId evento di modifica delle proprietà. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Se il controllo supporta il pattern di controllo SelectionItem, deve supportare questo evento. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Se il controllo supporta il pattern di controllo SelectionItem, deve supportare questo evento. |
| UIA_SelectionItem_ElementSelectedEventId | Se il controllo supporta il pattern di controllo SelectionItem, deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Attiva/Disattiva, deve supportare questo evento. |
| UIA_ValueValuePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Value, deve supportare questo evento. |
Esempio di tipo di controllo DataItem
L'immagine seguente illustra un tipo di controllo DataItem in un controllo visualizzazione elenco.
La visualizzazione controllo e la visualizzazione contenuto dell'albero di automazione interfaccia utente relativa al controllo elemento di dati vengono visualizzati di seguito. I pattern di controllo per ogni elemento di automazione vengono visualizzati tra parentesi. Anche il gruppo "Contoso" fa parte della griglia del controllo host griglia dati. Per un esempio di struttura griglia di livello superiore, vedere tipo di controllo DataGrid.
| Albero di automazione interfaccia utente - Visualizzazione controllo | Albero di automazione interfaccia utente - Visualizzazione contenuto |
|---|---|
|
|
Se una griglia rappresenta un elenco di elementi selezionabili, gli elementi selezionabili dell'interfaccia utente corrispondenti possono essere esposti con il tipo di controllo ListItem anziché il tipo di controllo DataItem. Nell'esempio precedente, gli elementi DataItem ("Accounts Receivable.doc" e "Accounts Payable.doc") in Group ("Contoso") possono essere migliorati esponendoli come tipi di controllo ListItem perché tale tipo supporta già il pattern di controllo SelectionItem.
Argomenti correlati