Tipo di controllo ListItem

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente 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, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente 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 si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli elemento elenco e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • ListItem
    • Image (0 o più)
    • Text (0 o più)
    • Edit (0 o più)
  • ListItem

 

Gli elementi figlio di un controllo elemento di elenco all'interno della visualizzazione contenuto dell'albero 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 Automazione interfaccia utente per il tipo di controllo TreeItem.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà 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 di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 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 dell'elenco viene popolato in modo dinamico e non prevedibile, lasciare vuota la proprietà AutomationId .
UIA_BoundingRectanglePropertyId Vedere le note. Il valore di questa proprietà include l'area dei contenuti immagine e testo dell'elemento dell'elenco.
UIA_ClickablePointPropertyId Dipende da 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, verrà restituito 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 è uguale per tutti i framework dell'interfaccia utente.
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida per gli elenchi deve spiegare il motivo per cui all'utente viene chiesto di effettuare una selezione da un elenco di opzioni, che è in genere lo stesso tipo di informazioni visualizzate tramite una descrizione comando. Ad esempio, "Selezionare un elemento per impostare la risoluzione di visualizzazione per il monitor".
UIA_IsContentElementPropertyId TRUE Il controllo elenco viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo elenco viene sempre incluso nella visualizzazione controllo dell'albero 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 da Questa proprietà deve restituire un valore che indica se l'elemento dell'elenco è attualmente sottoposto a scorrimento nella visualizzazione all'interno del contenitore padre che implementa il pattern di controllo Scroll .
UIA_ItemStatusPropertyId Dipende da Se il controllo contiene lo stato che viene aggiornato in modo dinamico, questa proprietà deve essere supportata in modo che un'assistive technology possa ricevere aggiornamenti quando lo stato dell'elemento cambia.
UIA_ItemTypePropertyId Dipende da Questa proprietà deve essere esposta per i controlli elemento elenco che rappresentano un oggetto sottostante. In genere, questi controlli elemento elenco includono un'icona associato al controllo che gli utenti associano all'oggetto sottostante.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statico, 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 è "elemento elenco" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il valore della proprietà name di un controllo elemento elenco deriva dall'etichetta di testo dell'elemento.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per essere supportati da tutti i controlli elemento dell'elenco. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto Note
IExpandCollapseProvider Dipende da Se l'elemento può essere modificato per visualizzare o nascondere informazioni, è necessario implementare il modello di controllo ExpandCollapse .
IGridItemProvider Dipende da Se lo spostamento spaziale da elemento a elemento è supportato all'interno del contenitore elenco e il contenitore viene disposto in righe e colonne, è necessario implementare il modello di controllo GridItem .
IInvokeProvider Dipende da Se l'elemento ha un comando che può essere eseguito su di esso, separato dalla selezione, è necessario implementare il modello di controllo Invoke . In genere si tratta di un'azione associata all'esecuzione del doppio clic sul controllo elemento elenco. Gli esempi sono l'avvio di un documento da Esplora risorse o la riproduzione di un file musicale in Microsoft Lettore multimediale Windows.
IScrollItemProvider Dipende da Se l'elemento di elenco è contenuto all'interno di un contenitore scorrevole, è necessario implementare il modello di controllo ScrollItem .
ISelectionItemProvider Dipende da Un controllo elemento elenco che supporta la selezione deve implementare il modello di controllo SelectionItem . Ciò consente ai controlli elemento elenco di indicare quando sono selezionati.
IToggleProvider Dipende da Se l'elemento di elenco è controllabile e l'azione non esegue una modifica dello stato di selezione, è necessario implementare il modello di controllo Disattiva .
IValueProvider Dipende da Se l'elemento può essere modificato, è necessario implementare il modello di controllo Valore . Le modifiche apportate al controllo elemento elenco causano modifiche ai valori delle proprietà UIA_NamePropertyId e UIA_ValueValuePropertyId .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che i controlli dell'elemento di elenco sono necessari per supportare. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_ExpandCollapseExpandCollapseStatePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo ExpandCollapse , deve supportare questo evento.
UIA_Invoke_InvokedEventId Se il controllo supporta il modello di controllo Invoke , deve supportare questo evento.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_ItemStatusPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà ItemStatus , è necessario supportare questo evento.
UIA_NamePropertyId evento modificato dalla proprietà.
UIA_SelectionItem_ElementAddedToSelectionEventId Se il controllo supporta il modello di controllo SelectionItem , deve supportare questo evento.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Se il controllo supporta il modello di controllo SelectionItem , deve supportare questo evento.
UIA_SelectionItem_ElementSelectedEventId Se il controllo supporta il modello di controllo SelectionItem , deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Attiva attivazione, deve supportare questo evento.
UIA_ValueValuePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Value , deve supportare questo evento.

 

Commenti

Se un contenitore ospita elementi di elenco, i mezzi di spostamento principali devono passare agli elementi dell'elenco. L'inserimento dello stato attivo sui sottoelementi tramite lo spostamento elenco può essere confuso con 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 passare attraverso gli elementi, ma premendo i tasti FRECCIA DESTRA e FRECCIA SINISTRA può passare ai sottoelementi dell'elemento incentrato, ad esempio colonne elenco o sottoelementi dell'interfaccia utente.

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente