Padrão de controle de grade
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
- Membros necessários para IGridProvider
- Tópicos relacionados
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).
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.
Tópicos relacionados