Condividi tramite

Tipo di controllo ListItem

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo ListItem.

I controlli elemento elenco sono un esempio di controlli che implementano il tipo di controllo ListItem.

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 ListItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli degli elementi di elenco 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

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli degli elementi di elenco 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
  • ListItem
    • Immagine (0 o più)
    • Testo (0 o più)
    • Modifica (0 o più)
  • ListItem

 

Gli elementi figlio di un controllo elemento di elenco all'interno della visualizzazione contenuto dell'albero di automazione interfaccia utente devono sempre mostrare zero elementi figlio. Se la struttura del controllo è tale che altri elementi siano contenuti sotto l'elemento dell'elenco, è necessario rispettare i requisiti per il supporto dell'automazione interfaccia utente per il tipo di controllo TreeItem.

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo ListItem. 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. Allocare la proprietà AutomationId per una voce di elenco se l'elemento è noto per essere coerente tra istanze diverse dell'interfaccia utente. Se l'elemento di elenco viene popolato in modo dinamico e non prevedibile, lasciare vuota la proprietà AutomationId.
UIA_BoundingRectanglePropertyId Vedere le note. Questo valore di questa proprietà deve includere l'area dell'immagine e il contenuto del testo dell'elemento di elenco.
UIA_ClickablePointPropertyId Dipende Se il controllo elenco dispone di un punto selezionabile (un punto su cui è possibile fare clic per fare in modo che l'elenco prenda lo stato attivo), tale punto deve essere esposto tramite questa proprietà. Se il controllo elenco è completamente coperto da elementi elenco discendenti, restituirà l'errore UIA_E_NOCLICKABLEPOINT per indicare che il client deve chiedere un elemento all'interno del controllo elenco per un punto selezionabile.
UIA_ControlTypePropertyId ListItem Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida per i controlli elenco deve spiegare il motivo per cui all'utente viene chiesto di scegliere un elenco di opzioni, che in genere è lo stesso tipo di informazioni presentate tramite una descrizione comando. Ad esempio, "Selezionare un elemento per impostare la risoluzione di visualizzazione per il monitor".
UIA_IsContentElementPropertyId TRUE Il controllo elenco è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo elenco è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il contenitore può accettare l'input da tastiera, questo valore della proprietà deve essere TRUE.
UIA_IsOffscreenPropertyId Dipende Questa proprietà deve restituire un valore che indica se l'elemento di elenco è attualmente sottoposto a scorrimento nella visualizzazione all'interno del contenitore padre che implementa pattern di controllo Scroll.
UIA_ItemStatusPropertyId Dipende 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 Dipende Questa proprietà deve essere esposta per i controlli elemento di elenco che rappresentano un oggetto sottostante. Questi controlli elemento elenco hanno in genere un'icona associata al controllo associato agli utenti con l'oggetto sottostante.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo ListItem. Il valore predefinito è "voce elenco" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il valore della proprietà name di un controllo voce di elenco deriva dall'etichetta di testo dell'elemento.

 

Modelli di controllo obbligatori

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli elemento elenco. 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 può essere modificato per mostrare o nascondere informazioni, è necessario implementare il pattern di controllo ExpandCollapse.
IGridItemProvider Dipende Se lo spostamento spaziale da elemento a elemento è supportato all'interno del contenitore elenco e il contenitore è disposto in righe e colonne, è necessario implementare il pattern di controllo GridItem.
IInvokeProvider Dipende Se l'elemento dispone di un comando che può essere eseguito su di esso, separato dalla selezione, è necessario implementare il pattern di controllo invoke. Si tratta in genere di un'azione associata al doppio clic sul controllo voce di elenco. Alcuni esempi potrebbero avviare un documento da Esplora risorse o riprodurre un file musicale in Microsoft Windows Media Player.
IScrollItemProvider Dipende Se l'elemento di elenco è contenuto all'interno di un contenitore scorrevole, è necessario implementare il pattern di controllo ScrollItem.
ISelectionItemProvider Dipende Un controllo elemento elenco che supporta la selezione deve implementare il pattern di controllo SelectionItem. In questo modo, i controlli degli elementi di elenco possono comunicare quando vengono selezionati.
IToggleProvider Dipende Se l'elemento di elenco è selezionabile e l'azione non esegue una modifica dello stato di selezione, è necessario implementare il Attiva/Disattiva pattern di controllo.
IValueProvider Dipende Se l'elemento può essere modificato, è necessario implementare il pattern di controllo valore. Le modifiche apportate al controllo elemento elenco causeranno modifiche ai valori delle proprietà UIA_NamePropertyId e UIA_ValueValuePropertyId.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli degli elementi di elenco. 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.

 

Osservazioni

Se un contenitore ospita voci di elenco, i mezzi principali di spostamento devono passare agli elementi dell'elenco. L'inserimento dello stato attivo sui sottoelementi tramite lo spostamento elenco può generare confusione per gli utenti e gli strumenti di accessibilità. Se il contenitore ospita un elenco verticale di elementi, premere i tasti FRECCIA SU e FRECCIA GIÙ deve spostarsi tra gli elementi, ma premendo freccia DESTRA e i tasti FRECCIA SINISTRA possono passare ai sottoelementi dell'elemento attivo, ad esempio colonne elenco o sottoelementi dell'interfaccia utente.

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente