Implementar el patrón de control Table de UI Automation

  • Artículo

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.

Table with complex header items. Ejemplo de tabla con encabezados de columna complejos

Table with ambiguous RowOrColumnMajor property. 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