Condividi tramite

Implementazione del pattern di controllo Table di automazione interfaccia utente

  • Articolo

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di ITableProvider, incluse le informazioni relative a proprietà, metodi ed eventi. Alla fine della panoramica sono elencati collegamenti a ulteriore materiale di riferimento.

Il pattern di controllo TablePattern 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 devono essere organizzati in un sistema di coordinate logico bidimensionale che può essere attraversato da righe e colonne. Questo pattern di controllo è analogo a IGridProvider, con la differenza che qualsiasi controllo che implementa ITableProvider deve esporre anche una relazione a livello di intestazione di riga e/o colonna per ogni elemento figlio. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.

Linee guida e convenzioni di implementazione

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

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

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

  • Le intestazioni di riga e colonna possono includere un'intestazione principale nonché intestazioni di supporto.

Nota

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

Table with complex header items. Esempio di tabella con intestazioni di colonna complesse

Table with ambiguous RowOrColumnMajor property. Esempio di tabella con la proprietà RowOrColumnMajor definita in modo ambiguo

Membri obbligatori per ITableProvider

Le proprietà e i metodi seguenti sono obbligatori per l'interfaccia ITableProvider.

Membri obbligatori Tipo di membro Note
RowOrColumnMajor Proprietà None
GetColumnHeaders metodo None
GetRowHeaders metodo None

Questo pattern di controllo non è associato a eventi.

Eccezioni

Questo pattern di controllo non è associato a eccezioni.

Vedi anche