Patrón de control dock

  • Artículo

Describe instrucciones y convenciones para implementar IDockProvider, incluida información sobre las propiedades y los métodos. El patrón de control Dock se usa 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í. En la imagen siguiente se muestra un contenedor de acoplamiento con dos elementos secundarios. Para obtener ejemplos de controles que implementan este patrón de control, vea Tipos de control y sus patrones de control admitidos.

captura de pantalla que muestra el contenedor de acoplamiento con dos elementos secundarios acoplados

En este tema se incluyen las siguientes secciones.

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 ninguna propiedad del contenedor de acoplamiento ni las propiedades de los 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 cualquier espacio dentro del contenedor según el comportamiento de acoplamiento de su propiedad DockPosition . Por ejemplo, si se especifica DockPosition_Top , los lados izquierdo y derecho del control se expandirán para rellenar cualquier espacio disponible. Si se especifica DockPosition_Fill , los cuatro lados del control se expandirán para rellenar cualquier 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 necesarios para IDockProvider

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

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

 

Este patrón de control no tiene eventos asociados.

Tipos de control y sus patrones de control admitidos

Información general acerca de los patrones de control de UI Automation

Información general sobre el árbol de la UI Automation