Implementare il schema di controllo della tabella per l'automazione dell'interfaccia utente

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.

Questo argomento presenta linee guida e convenzioni per l'implementazione di ITableProvider, incluse informazioni su proprietà, metodi ed eventi. I collegamenti a riferimenti aggiuntivi sono elencati alla fine della panoramica.

Il TablePattern pattern di controllo viene usato per supportare i controlli che fungono da contenitori per una raccolta di elementi figlio. Gli elementi figlio di questo elemento devono implementare ITableItemProvider e essere organizzati in un sistema di coordinate logico bidimensionale che può essere attraversato da riga e colonna. Questo pattern di controllo è analogo a IGridProvider, con la distinzione che qualsiasi controllo che implementa ITableProvider deve esporre anche una relazione di intestazione di colonna e/o di riga per ogni elemento figlio. Per esempi di controlli che implementano questo pattern di controllo, vedere Mapping dei criteri di controllo per i client di automazione interfaccia utente.

Linee guida e convenzioni di implementazione

Quando si implementa il modello di controllo tabella, tenere presenti le linee guida e le convenzioni seguenti:

• L'accesso al contenuto di singole celle avviene tramite un sistema di coordinate logico bidimensionale o una matrice fornita dall'implementazione concorrente richiesta di IGridProvider.

• Un'intestazione di colonna o di riga può essere contenuta all'interno di un oggetto tabella o essere un oggetto intestazione separato associato a un oggetto tabella.

• Le intestazioni di colonna e di riga possono includere sia un'intestazione primaria che qualsiasi intestazione di supporto.

Annotazioni

Questo concetto diventa evidente in un foglio di calcolo di Microsoft Excel in cui un utente ha definito una colonna "Nome". Questa colonna include ora due intestazioni, ovvero l'intestazione "First name" definita dall'utente e la designazione alfanumerica per tale colonna assegnata dall'applicazione.

• Consultare Implementazione del modello di controllo della griglia di automazione dell'interfaccia utente per le funzionalità correlate alla griglia.

Esempio di tabella con intestazioni di colonna complesse

Esempio di una tabella con proprietà Ambigua RowOrColumnMajor

Membri obbligatori per ITableProvider

Per l'interfaccia ITableProvider sono necessari i metodi e le proprietà seguenti.

Membri obbligatori	Tipo di membro	Note
RowOrColumnMajor	Proprietà	Nessuno
GetColumnHeaders	Metodo	Nessuno
GetRowHeaders	Metodo	Nessuno

Questo pattern di controllo non è associato a eventi.

Eccezioni

Questo pattern di controllo non presenta eccezioni associate.

Vedere anche

• Panoramica dei modelli di controllo per l'automazione dell'interfaccia utente
• Supportare i Pattern di Controllo in un Provider di Automazione dell'Interfaccia Utente
• Modelli di Controllo di Automazione per l'Interfaccia Utente dei Client
• Implementazione del modello di controllo TableItem dell'automazione dell'interfaccia utente
• Implementazione dello schema di controllo griglia per l’automazione dell’interfaccia utente
• Panoramica dell'albero di automazione dell'interfaccia utente
• Usare il caching nell'automazione dell'interfaccia utente