Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto dell'Automazione dell'Interfaccia Utente per il tipo di controllo Tabella. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern 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 di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Tabella. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli di tabella, sia per Windows Presentation Foundation (WPF), che per Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione dei controlli e la visualizzazione del contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli della tabella e descrive cosa può contenere ciascuna visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | 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 contiene intestazioni di riga o di colonna, è necessario che vengano esposte nella visualizzazione del controllo dell'albero di automazione dell'interfaccia utente. La visualizzazione contenuto non deve esporre queste informazioni perché è possibile accedervi tramite TablePattern.
Proprietà di automazione interfaccia utente necessarie
Nella tabella seguente sono elencate 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 Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo tabella ottiene in genere il nome da un'etichetta di testo statica. Se non esiste un'etichetta di testo statica, è necessario assegnare una proprietà Name che deve essere sempre disponibile per spiegare lo scopo della tabella. |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento all'elemento di automazione del controllo. |
| ControlTypeProperty | Tabella | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | tavolo | Stringa localizzata corrispondente al tipo di controllo Table. |
| HelpTextProperty | Vedere le note. | Ulteriori dettagli sullo scopo della tabella devono essere esposti tramite questa proprietà se non è sufficientemente spiegato accedendo a NameProperty. |
| IsContentElementProperty | Vero | La tabella di controllo deve sempre contenere contenuti. |
| IsControlElementProperty | Vero | Il controllo tabella deve essere sempre mantenuto. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai 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 | Assistenza | Note |
|---|---|---|
| IGridProvider | Sì | Il controllo tabella supporta sempre questo pattern di controllo perché gli elementi che contengono contengono dati presentati in una griglia. |
| IGridItemProvider | Sì (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 i pattern di controllo GridItem o TableItem, a meno che la tabella non faccia parte di un'altra tabella. |
| ITableProvider | Sì | Il controllo tabella ha sempre la possibilità di avere intestazioni associate al contenuto. |
| ITableItemProvider | Sì (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 i pattern di controllo GridItem o TableItem, a meno che la tabella non faccia parte di un'altra tabella. |
Eventi di automazione interfaccia utente necessari
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 Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |