Condividi tramite

Tipo di controllo tabella

  • Articolo

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

I controlli tabella contengono righe e colonne di testo e, facoltativamente, intestazioni di riga e intestazioni di colonna.

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 tabella. I requisiti di automazione interfaccia utente si applicano a tutti i controlli tabella 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 tabella 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
  • Tavolo
    • Testo (0 o 1)
    • Intestazione (0 o più)
    • Vari controlli (0 o più)
  • Tavolo
    • Testo (1 o più)
    • Vari controlli (0 o più)

 

Se un controllo tabella contiene intestazioni di riga o di colonna, è necessario che vengano esposte nella visualizzazione controllo dell'albero di automazione interfaccia utente. La visualizzazione contenuto non deve esporre queste informazioni perché è accessibile tramite IUIAutomationTablePattern.

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli tabella. 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 tabella
UIA_DescribedByPropertyId Vedere le note. Se la tabella è annotata da un altro elemento dell'interfaccia utente, ad esempio un elemento di testo che contiene la descrizione per la tabella, la proprietà DescribedBy deve esporre un riferimento all'elemento di automazione del controllo di testo.
UIA_HelpTextPropertyId Vedere le note. Ulteriori dettagli sullo scopo della tabella devono essere esposti tramite questa proprietà se non è sufficientemente spiegato dalla proprietà UIA_NamePropertyId.
UIA_IsContentElementPropertyId VERO Il controllo tabella deve essere sempre visualizzato nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo tabella deve essere sempre visualizzato nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento all'elemento di automazione del controllo.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Table. Il valore predefinito è "table" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo tabella ottiene in genere il valore per il nome da un'etichetta di testo statica. Se non è presente un'etichetta di testo statica, l'elemento deve assegnare una proprietà Name che deve essere sempre disponibile per spiegare lo scopo della tabella.

 

Modelli di controllo obbligatori

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli tabella. 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
IGridProvider Obbligatorio Poiché il controllo tabella contiene elementi presentati in una griglia, supporta sempre il pattern di controllo Griglia di.
IGridItemProvider Obbligatorio con oggetti figlio Gli oggetti interni di una tabella devono supportare sia i pattern di controllo GridItem sia TableItem. La tabella stessa non deve supportare il pattern di controllo GridItem o TableItem, a meno che la tabella non faccia parte di un'altra tabella.
ITableProvider Obbligatorio Il controllo tabella può sempre avere intestazioni associate al contenuto.
ITableItemProvider Obbligatorio con oggetti figlio Gli oggetti interni di una tabella devono supportare sia i pattern di controllo GridItem sia TableItem. La tabella stessa non deve supportare i pattern di controllo GridItem o TableItem, a meno che la tabella non faccia parte di un'altra tabella.

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli tabella. 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_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_StructureChangedEventId

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente