Implementar el patrón de control Table de UI Automation
Nota
Esta documentación está dirigida a los desarrolladores de .NET Framework que quieran usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para ver la información más reciente acerca de la automatización de la interfaz de usuario, consulte Windows Automation API: automatización de la interfaz de usuario.
En este tema se presentan las directrices y convenciones para implementar ITableProvider, incluida la información sobre propiedades, métodos y eventos. Al final de la información general se proporcionan vínculos a referencias adicionales.
El patrón de control TablePattern se usa para admitir controles que actúen como contenedores para una colección de elementos secundarios. Los elementos secundarios de este elemento deben implementar ITableItemProvider y organizarse en un sistema de coordenadas lógico bidimensional que se pueda recorrer por filas y columnas. Este patrón de control es análogo a IGridProvider, con la diferencia de que cualquier control que implemente ITableProvider también debe exponer una relación de encabezado de columna o fila para cada elemento secundario. Para obtener ejemplos de controles que implementan este patrón de control, vea Control Pattern Mapping for UI Automation Clients.
Directrices y convenciones de implementación
Al implementar el patrón de control Table, tenga en cuenta las siguientes directrices y convenciones:
El acceso al contenido de celdas individuales se realiza a través de un sistema de coordenadas lógico bidimensional o la matriz ofrecida por la implementación simultánea necesaria de IGridProvider.
Un encabezado de columna o fila puede estar dentro de un objeto de tabla o ser un objeto de encabezado independiente asociado a un objeto de tabla.
Los encabezados de fila y columna pueden incluir tanto un encabezado principal como cualquier encabezado auxiliar.
Nota:
Este concepto se vuelve evidente en una hoja de cálculo de Microsoft Excel donde un usuario ha definido una columna "Nombre". Esta columna tiene ahora dos encabezados: el encabezado "Nombre" definido por el usuario y la designación alfanumérica para esa columna asignada por la aplicación.
- Para ver la funcionalidad relacionada de los elementos de cuadrícula, consulte Implementar el patrón de control Grid de Automatización de la interfaz de usuario.
Ejemplo de tabla con encabezados de columna complejos
Ejemplo de tabla con la propiedad RowOrColumnMajor ambigua
Miembros requeridos para ITableProvider
Se requieren los siguientes métodos y propiedades para la interfaz de ITableProvider.
Miembros requeridos | Tipo de miembro | Notas |
---|---|---|
RowOrColumnMajor | Propiedad | None |
GetColumnHeaders | Método | None |
GetRowHeaders | Método | None |
Este patrón de control no tiene eventos asociados.
Excepciones
Este patrón de control no tiene excepciones asociadas.
Consulte también
- Información general acerca de los patrones de control de UI Automation
- Patrones de control compatibles en un proveedor de UI Automation
- Patrones de controles de UI Automation para clientes
- Implementar el patrón de control TableItem de UI Automation
- Implementar el patrón de control Grid de UI Automation
- Información general sobre el árbol de la UI Automation
- Utilizar el almacenamiento en caché en la UI Automation