Padrão de controle de grade

  • Artigo

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

Os filhos desse elemento devem implementar IGridItemProvider e ser organizados em um sistema de coordenadas lógicas bidimensionais que pode ser percorrido por linha e coluna. 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 Grid , observe as seguintes diretrizes e convenções:

  • As coordenadas de grade são baseadas em zero com a célula superior esquerda (ou superior direita, dependendo da localidade) com coordenadas (0,0).

  • Se uma célula estiver vazia, um elemento microsoft Automação da Interface do Usuário ainda deverá ser retornado para dar suporte à propriedade IGridItemProvider::ContainingGrid para essa célula. Isso é possível quando o layout dos elementos filho na grade é semelhante a uma matriz irregular (veja o exemplo abaixo).

    exemplo de um controle de grade com coordenadas vazias

  • Uma grade com um único item ainda será necessária para implementar iGridProvider se for logicamente considerada uma grade. O número de itens filho na grade é irrelevante.

  • Linhas e colunas ocultas, dependendo da implementação do provedor, podem ser carregadas na árvore Automação da Interface do Usuário e, portanto, serão refletidas nas propriedades IGridProvider::RowCount e ColumnCount. Se as linhas e colunas ocultas ainda não tiverem sido carregadas, elas não deverão ser contadas.

  • O IGridProvider não habilita a manipulação ativa de uma grade; ITransformProvider deve ser implementado para habilitar essa funcionalidade.

  • Use um IUIAutomationStructureChangedEventHandler para escutar alterações estruturais ou de layout na grade, como células que foram adicionadas, removidas ou mescladas.

  • Use um IUIAutomationFocusChangedEventHandler para acompanhar a passagem pelos itens ou células de uma grade.

Membros necessários para IGridProvider

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

Membros necessários Tipo de membro Observações
Rowcount Propriedade Nenhum
Columncount Propriedade Nenhum
Getitem Método Nenhum

 

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

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

Padrão de controle GridItem

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