Partilhar via


Padrão de controle de tabela

Descreve diretrizes e convenções para implementar ITableProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Table é usado para dar suporte a controles que atuam como contêineres para uma coleção de elementos filho.

Os filhos do elemento contêiner devem implementar ITableItemProvider e ser organizados em um sistema de coordenadas lógicas bidimensionais que pode ser percorrido por linha e coluna. Esse padrão de controle é análogo a IGridProvider com a distinção de que qualquer controle 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 Tipos de controle e seus padrões de controle com suporte.

Este tópico inclui as seções a seguir.

Diretrizes e convenções de implementação

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

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

  • Um cabeçalho de coluna ou linha pode ser 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

    Esse conceito fica evidente em uma planilha do Microsoft Excel em que um usuário definiu uma coluna Nome . Esta coluna agora tem dois cabeçalhos, incluindo o cabeçalho Nome definido pelo usuário e a designação alfanumérica para essa coluna atribuída pelo aplicativo.

     

  • Consulte Padrão de Controle de Grade para obter a funcionalidade de grade relacionada.

    A imagem a seguir mostra uma tabela com cabeçalhos de coluna complexos.

    tabela com cabeçalhos de coluna complexos

    A imagem a seguir mostra uma tabela com uma propriedade ITableProvider::RowOrColumnMajor ambígua.

    tabela com uma propriedade roworcolumnmajor ambígua

Membros necessários para ITableProvider

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

Membros necessá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.

Conceitual

Tipos de controle e seus padrões de controle com suporte

Padrão de controle TableItem

Visão Geral de Padrões de Controle de Automação de Interface de Usuário

Visão geral da árvore de automação de interface do usuário