Tipo di controllo tabella

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Table.

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 Automazione interfaccia utente, le proprietà, i modelli 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 dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

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

Visualizzazione controlli Visualizzazione contenuto
  • Tabella
    • Text (0 o 1)
    • Intestazione (0 o più)
    • Vari controlli (0 o più)
  • Tabella
    • Testo (1 o più)
    • Vari controlli (0 o più)

 

Se un controllo tabella dispone di intestazioni di riga o colonna, è necessario esporre nella visualizzazione controllo dell'albero Automazione interfaccia utente. La visualizzazione contenuto non deve esporre queste informazioni perché può essere accessibile usando IUIAutomationTablePattern.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli tabella. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle 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.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable.
UIA_ControlTypePropertyId Tabella
UIA_DescribedByPropertyId Vedere le note. Se la tabella viene annotata mediante altri elementi dell'interfaccia utente, ad esempio un elemento di testo contenente la descrizione della tabella, la proprietà DescribedBy deve esporre un riferimento all'elemento di automazione del controllo 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 TRUE Il controllo tabella deve sempre essere visualizzato nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo tabella deve sempre essere visualizzato nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statico, 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 relativo nome da un'etichetta di testo statica. Se non esiste 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

Nella tabella seguente sono elencati i modelli di controllo 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.

Pattern di controllo Supporto Note
IGridProvider Necessario Poiché il controllo tabella contiene elementi presentati in una griglia, supporta sempre il modello di controllo Griglia .
IGridItemProvider Obbligatorio con oggetti figlio Gli oggetti interni di una tabella devono supportare sia i modelli di controllo GridItem che TableItem . La tabella stessa non deve supportare il modello di controllo GridItem o TableItem, a meno che la tabella non faccia parte di un'altra tabella.
ITableProvider Necessario 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 che 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.

 

Eventi obbligatori

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

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_StructureChangedEventId

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente