Implementação do padrão de controlo de automação de tabelas da interface do utilizador

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico apresenta diretrizes e convenções para implementar ITableProvider, incluindo informações sobre propriedades, métodos e eventos. Os links para referências adicionais estão listados no final da visão geral.

O TablePattern padrão de controle é usado para dar suporte a controles que atuam como contêineres para uma coleção de elementos filho. Os filhos deste elemento devem implementar ITableItemProvider e ser organizados num sistema de coordenadas lógicas bidimensionais que pode ser percorrido por linhas e colunas. Este padrão de controlo é análogo ao IGridProvider, com a distinção de que qualquer controlo que implemente ITableProvider também deve expor uma relação de cabeçalho de coluna e/ou linha para cada elemento filho. Para obter exemplos de controles que implementam esse padrão de controle, consulte Control Pattern Mapping for UI Automation Clients.

Orientações e convenções de aplicação

Ao implementar o padrão de controlo de Tabela, observe as seguintes diretrizes e convenções:

• O acesso ao conteúdo de células individuais é feito através de um sistema de coordenadas lógicas bidimensionais ou matriz fornecida pela implementação simultânea necessária do IGridProvider.

• Um cabeçalho de coluna ou linha pode estar contido em um objeto de tabela ou ser um objeto de cabeçalho separado associado a um objeto de tabela.

• Os cabeçalhos de coluna e linha podem incluir um cabeçalho primário, bem como quaisquer cabeçalhos de suporte.

Observação

Este conceito torna-se evidente numa folha de cálculo do Microsoft Excel onde um utilizador definiu uma coluna "Nome próprio". Esta coluna agora tem dois cabeçalhos — o cabeçalho "Primeiro nome" definido pelo utilizador e a designação alfanumérica para essa coluna atribuída pela aplicação.

• Consulte Implementação do padrão de controlo de grelha de automação da interface do utilizador para obter funcionalidades relacionadas com grelhas.

Exemplo de uma tabela com cabeçalhos de coluna complexos

Exemplo de uma tabela com propriedade ambígua RowOrColumnMajor

Membros necessários para ITableProvider

As propriedades e métodos a seguir são necessários para a interface ITableProvider.

Membros obrigatórios	Tipo de membro	Observações
RowOrColumnMajor	Propriedade	Nenhum
GetColumnHeaders	Método	Nenhum
GetRowHeaders	Método	Nenhum

Esse padrão de controle não tem eventos associados.

Exceções

Esse padrão de controle não tem exceções associadas.

Ver também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suportar Padrões de Controle em um Provedor de Automação de Interface do Usuário
• Padrões de Controle de Automação da Interface do Usuário para Clientes
• Implementando o padrão de controle TableItem de automação da interface do usuário
• Implementando o Padrão de Controlo de Grelha da Automação da Interface do Utilizador
• Visão geral da árvore de automação da interface do usuário
• Use o armazenamento em cache na automação da interface do utilizador