Supporto per automazione interfaccia utente del tipo di controllo Table
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Table. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
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, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo Table. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli tabella, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli tabella e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Tabella - Intestazione (0 o 1) - Testo (0 o 1) - Vari controlli (0 o più) |
Tabella - Testo (0 o più) - Vari controlli (0 o più) |
Se un controllo tabella include intestazioni di riga o colonna, queste informazioni devono essere esposte nella visualizzazione controlli dell'albero di automazione interfaccia utente. La visualizzazione contenuto non deve esporre queste informazioni perché è possibile accedervi usando la proprietà TablePattern.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli Table. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo tabella in genere ricava il proprio nome da un'etichetta di testo statico. Se non è presente alcuna etichetta di testo statico, è necessario assegnare una proprietà Name che deve essere sempre disponibile per descrivere lo scopo della tabella. |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statico, questa proprietà deve esporre un riferimento all'elemento di automazione del controllo. |
| ControlTypeProperty | Tabella | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "table" | Stringa localizzata corrispondente al tipo di controllo Table. |
| HelpTextProperty | Vedere le note. | Altre informazioni sullo scopo della tabella devono essere esposte tramite questa proprietà se non viene illustrata in modo sufficiente accedendo alla proprietà NameProperty. |
| IsContentElementProperty | Vero | Il controllo tabella deve essere sempre di tipo contenuto. |
| IsControlElementProperty | Vero | Il controllo tabella deve essere sempre un controllo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i modelli di controllo di Automazione interfaccia utente che devono essere supportati dai controlli Table. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IGridProvider | Sì | Il controllo tabella supporta sempre questo pattern di controllo perché gli elementi che contiene dispone di dati visualizzati in una griglia. |
| IGridItemProvider | Sì (obbligatorio con oggetti figlio) | Gli oggetti interni di una tabella devono supportare sia il pattern di controllo GridItem sia il pattern di controllo 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 | Sì | Il controllo tabella supporta sempre l'associazione di intestazioni al contenuto. |
| ITableItemProvider | Sì (obbligatorio con oggetti figlio) | Gli oggetti interni di una tabella devono supportare sia il pattern di controllo GridItem sia il pattern di controllo 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 di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli tabella. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |