Implementación del patrón de control de tabla para automatización de la interfaz de usuario

Nota:

Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.

En este tema se presentan instrucciones y convenciones para implementar ITableProvider, incluida información sobre propiedades, métodos y eventos. Los vínculos a referencias adicionales aparecen al final de la información general.

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 distinción 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, consulte Asignación de patrones de control para clientes de automatización de la interfaz de usuario.

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ógicos bidimensional o una matriz proporcionados por la implementación simultánea necesaria de IGridProvider.

• Un encabezado de columna o fila se puede contener dentro de un objeto table o ser un objeto de encabezado independiente asociado a un objeto table.

• Los encabezados de columna y fila pueden incluir un encabezado principal, así como los encabezados auxiliares.

Nota:

Este concepto se vuelve evidente en una hoja de cálculo de Microsoft Excel donde un usuario ha definido una columna "Nombre de pila". Esta columna ahora tiene dos encabezados: el encabezado "First name" definido por el usuario y la designación alfanumérica de 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 una tabla con encabezados de columna complejos

Ejemplo de una tabla con una propiedad RowOrColumnMajor ambigua

Miembros necesarios para ITableProvider

Las siguientes propiedades y métodos son necesarios para la interfaz ITableProvider.

Miembros necesarios	Tipo de miembro	Notas
RowOrColumnMajor	Propiedad	Ninguno
GetColumnHeaders	Método	Ninguno
GetRowHeaders	Método	Ninguno

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 control de automatización de la interfaz de usuario para clientes
• Implementación del patrón de control TableItem de UI Automation
• Implementación del patrón de control de cuadrícula de automatización de la interfaz de usuario
• Información general sobre el árbol de la UI Automation
• Utilizar el almacenamiento en caché en la automatización de la interfaz de usuario