Compartir a través de

Patrón de control de cuadrícula

  • Artículo

Describe instrucciones 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.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

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

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

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

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

  • Todavía se requiere una cuadrícula con un solo elemento para implementar IGridProvider si se considera lógicamente una cuadrícula. El número de elementos secundarios de la cuadrícula es inmaterial.

  • 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 tanto, se reflejarán en las propiedades IGridProvider::RowCount y ColumnCount. Si aún no se han cargado las filas y columnas ocultas, 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 unIUIAutomationFocusChangedEventHandler 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 interfazIGridProvider.

Miembros necesarios Tipo de miembro Notas
rowCount de Propiedad Ninguno
columnCount Propiedad Ninguno
GetItem Método Ninguno

 

Este patrón de control no tiene eventos asociados.

tipos de control y sus patrones de control admitidos

patrón de control GridItem

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de