Compartir a través de


Implementar el patrón de control Dock 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 IDockProvidery se incluye información sobre propiedades. Al final del tema se ofrecen vínculos a referencias adicionales.

El patrón de control DockPattern se utiliza para exponer las propiedades de acoplamiento de un control dentro de un contenedor de acoplamiento. Un contenedor de acoplamiento es un control que permite organizar elementos secundarios horizontal y verticalmente, relacionados entre sí. Para obtener ejemplos de controles que implementan este patrón de control, vea Control Pattern Mapping for UI Automation Clients.

Docking container with two docked children. Ejemplo de acoplamiento de Visual Studio en el que la ventana "Vista de clases" es DockPosition.Right y la ventana "Lista de errores" es DockPosition.Bottom

Directrices y convenciones de implementación

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

  • IDockProvider no expone propiedades del contenedor de acoplamiento ni propiedades de controles que estén acoplados adyacentes al control actual dentro del contenedor de acoplamiento.

  • Los controles se acoplan de forma relativa entre ellos, según su valor actual de orden Z; cuanto mayor es su ubicación de orden Z, más lejos se colocan del borde especificado del contenedor de acoplamiento.

  • Si se cambia el tamaño del contenedor de acoplamiento, los controles acoplados dentro del contenedor cambiarán de posición y se alinearán con el mismo borde en el que estaban originalmente acoplados. Los controles acoplados también cambiarán de tamaño para rellenar el espacio dentro del contenedor según el comportamiento de acoplamiento de sus elementos DockPosition. Por ejemplo, si se especifica Top , los lados izquierdo y derecho del control se expandirán para rellenar el espacio disponible. Si se especifica Fill , los cuatro lados del control se expandirán para rellenar el espacio disponible.

  • En un sistema de varios monitores, los controles se deben acoplar en el lado izquierdo o derecho del monitor actual. Si no es posible, deben acoplarse en el lado izquierdo del monitor que se encuentre más a la izquierda o en el lado derecho del monitor que se encuentre más a la derecha.

Miembros requeridos para IDockProvider

Se requieren los métodos y propiedades siguientes para implementar la interfaz de IDockProvider.

Miembros requeridos Tipo de miembro Notas
DockPosition Propiedad None
SetDockPosition Método None

Este patrón de control no tiene eventos asociados.

Excepciones

Los proveedores deben producir las siguientes excepciones.

Tipo de excepción Condición
InvalidOperationException SetDockPosition

- Cuando un control no puede ejecutar el estilo de acoplamiento solicitado.

Consulte también