Patrón de control de cuadrícula

  • Artículo

Describe directrices y convenciones para implementar IGridProvider, incluida información sobre las propiedades y los métodos. El patrón de control Grid se usa para admitir controles que actúan como contenedores para una colección de elementos secundarios.

Los elementos secundarios de este elemento deben implementar IGridItemProvider y organizarse en un sistema de coordenadas lógicas bidimensionales que se puede recorrer por fila y columna. Para obtener ejemplos de controles que implementan este patrón de control, vea Tipos de control y Sus patrones de control admitidos.

En este tema se incluyen las siguientes secciones.

Directrices y convenciones de implementación

Al implementar el patrón de control Grid , tenga en cuenta las siguientes directrices y convenciones:

  • Las coordenadas de cuadrícula se basan en cero con la celda superior izquierda (o superior derecha en función de la configuración regional) con coordenadas (0,0).

  • Si una celda está vacía, se debe devolver un elemento de Microsoft Automatización de la interfaz de usuario para admitir la propiedad IGridItemProvider::ContainingGrid para esa celda. Esto es posible si el diseño de elementos secundarios de la cuadrícula es similar a una matriz irregular (consulte el ejemplo siguiente).

    ejemplo de un control de cuadrícula con coordenadas vacías

  • Una cuadrícula con un solo elemento sigue siendo necesaria para implementar IGridProvider si se considera lógicamente una cuadrícula. El número de elementos secundarios de la cuadrícula es irrelevante.

  • Las filas y columnas ocultas, según la implementación del proveedor, se pueden cargar en el árbol de Automatización de la interfaz de usuario y, por lo tanto, se reflejarán en las propiedades IGridProvider::RowCount y ColumnCount. Si las filas y columnas ocultas todavía no se han cargado, no deben contarse.

  • IGridProvider no habilita la manipulación activa de una cuadrícula; ITransformProvider debe implementarse para habilitar esta funcionalidad.

  • Use un IUIAutomationStructureChangedEventHandler para escuchar cambios estructurales o de diseño en la cuadrícula, como las celdas que se han agregado, quitado o combinado.

  • Use un IUIAutomationFocusChangedEventHandler para realizar un seguimiento del recorrido a través de los elementos o celdas de una cuadrícula.

Miembros necesarios para IGridProvider

Se requieren las siguientes propiedades y métodos para implementar la interfaz IGridProvider .

Miembros requeridos Tipo de miembro Notas
Rowcount Propiedad None
ColumnCount Propiedad None
Getitem Método None

 

Este patrón de control no tiene eventos asociados.

Tipos de control y sus patrones de control admitidos

Patrón de control GridItem

Información general acerca de los patrones de control de UI Automation

Información general sobre el árbol de la UI Automation