Implementando o Padrão Controle Grid de Automação de Interface de Usuário

Artigo
08/25/2010

Este tópico apresenta diretrizes e convenções para a implementação IGridProviderIncluindo informações sobre propriedades, métodos e eventos.Links para referências adicionais são listadas no final da revisão.

O GridPattern Controle padrão é usada para oferecer suporte Controles que atuam como recipientes para uma coleção de elementos filho.Os filhos deste elemento devem implementar IGridItemProvedor e ser organizados em um sistema de coordenadas lógico bidimensional que podem ser transmitido por linha e coluna.Para obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de Padrão de Controles para Clientes de Automação de IU.

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

Orientações e Convenções de Implementação
Membros Requeridos para IGridProvider
Exceções
Tópicos relacionados

Orientações e Convenções de Implementação

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

Coordenadas de Grid são baseadas em zero com o canto superior esquerdo (ou célula superior direita dependendo da localidade) tendo as coordenadas (0, 0).
Se uma célula for Vazio, um Elemento interface do usuário de automação ainda devem ser retornados em Ordem para oferecer suporte a ContainingGrid() Propriedade para essa célula.Isso é possível quando o layout dos elementos filhos na grade é semelhante a uma matriz irregular (veja exemplo abaixo).

Exemplo de um controle de grade com coordenadas vazias

Uma grade com um Simples item ainda é necessária para implementar IGridProvider Se ele for considerado logicamente para ser uma grade.O número de itens filhos na grade é irrelevante.
Oculta linhas e colunas, the Pendente na implementação do provedor, pode ser carregado na árvore e, portanto, será Refletido in a [P:System.Windows.Automation.GridPadrão.GridPadrãoInformation.RowCount] e ColumnCount Propriedades.Se as linhas e colunas ocultas ainda não tiverem sido carregadas, elas não serão consideradas.
IGridProvider Não ative Ativo a manipulação de uma grade; ITransformProvider deve ser implementado para habilitar essa funcionalidade.
Use um StructureChangedEventHandler Para ouvir estrutural ou layout altera para a grade como células que foram adicionados, removidos ou mescladas.
Use um AutomationFocusChangedEventHandler Para controlar passagem Através de itens ou células de uma grade.

Membros Requeridos para IGridProvider

As propriedades e métodos a seguir são necessários para implementação da interface IGridProvider.

Membros Requeridos	Type (Tipo)	Anotações
RowCount	Propriedade	Nenhum
ColumnCount	Propriedade	Nenhum
GetItem	Método	Nenhum

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

Exceções

Provedores precisam lançar as seguintes exceções.

Tipo de exceção	Condição
ArgumentOutOfRangeException	GetItem Se a linha solicitada coordenada for Grande do que o RowCount ou a coluna coordenada é maior do que o ColumnCount.
ArgumentOutOfRangeException	GetItem Se a coordenada da linha ou da coluna é menor que zero.

ArgumentOutOfRangeException

GetItem