Implementar el patrón de control Dock de UI Automation

Artículo
08/10/2011

Nota
Esta documentación está dirigida a desarrolladores de .NET Framework que desean usar las clases administradas de UI Automation definidas en el espacio de nombres System.Windows.Automation.Para obtener información actualizada sobre UI Automation, vea Windows Automation API: UI Automation.

Este tema incluye las directrices y convenciones de implementación de IDockProvider, incluida la información acerca de propiedades. Los vínculos a referencias adicionales se enumeran al final del tema.

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 del acoplamiento es un control que permite organizar los elementos secundarios horizontalmente y verticalmente, en relación unos con otros. En el caso de ejemplos de controles que implementan este patrón de control, vea Asignación de patrones de controles para clientes de UI Automation.

Ejemplo de acoplamiento de Visual Studio donde la ventana "Vista de clases " es DockPosition.Right y la ventana "Lista de errores" es DockPosition.Bottom

Acoplar contenedor con dos secundarios acoplados.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación
Miembros necesarios para IDockProvider
Excepciones
Temas relacionados

Directrices y convenciones de implementación

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

IDockProvider no expone ninguna propiedad del contenedor de acoplamiento ni de los controles acoplados adyacentes al control actual en el contenedor de acoplamiento.
Los controles se acoplan unos con respecto a otros basándose en su orden Z actual; cuanto más alta sea su posición en el orden Z, más lejos se colocan del borde especificado del contenedor de acoplamiento.
Si se cambia el tamaño del contenedor del acoplamiento, los controles acoplados que haya dentro del contenedor cambiarán de posición alineados al mismo borde al que se acoplaron originalmente. Los controles acoplados también cambiarán de tamaño para rellenar el espacio dentro del contenedor según el comportamiento del acoplamiento de sus enumeraciones 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 con varios monitores, los controles deben acoplarse al lado izquierdo o derecho del monitor actual. Si eso no es posible, deben acoplarse al lado izquierdo del monitor del extremo izquierdo o al lado derecho del monitor del extremo derecho.