Padrão de controle de grade

Descreve diretrizes e convenções para implementar 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 suportados.

Este tópico contém as seguintes seções.

• Diretrizes de Implementação e Convenções
• Membros necessários para IGridProvider
• Tópicos relacionados

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

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

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

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

  

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

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

• IGridProvider não permite a manipulação ativa de uma grade; ITransformProvider deve ser implementada 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 rastrear a travessia pelos itens ou células de uma grade.

Membros necessários para IGridProvider

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

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

Tópicos relacionados

tipos de controle e seus padrões de controle suportados

padrão de controle GridItem

Visão geral dos padrões de controle de automação da interface do do usuário

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