Implementar el patrón de control Dock de UI Automation

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 IDockProvider, incluida la información sobre las 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 de acoplamiento es un control que permite organizar los elementos secundarios horizontal y verticalmente, en relación entre sí. 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.

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 entre sí en función de su orden z actual; cuanto mayor sea su ubicación de orden z, más lejos se colocan desde el borde especificado del contenedor de acoplamiento.

• Si se cambia el tamaño del contenedor de acoplamiento, los controles acoplados dentro del contenedor se cambiarán de posición 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 de acoplamiento de sus elementos DockPosition. Por ejemplo, si Top se especifica , los lados izquierdo y derecho del control se expandirán para rellenar cualquier espacio disponible. Si Fill se especifica, los cuatro lados del control se expandirán para rellenar cualquier espacio disponible.

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

Miembros necesarios para IDockProvider

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

Miembros necesarios	Tipo de miembro	Notas
DockPosition	Propiedad	Ninguno
SetDockPosition	Método	Ninguno

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

• 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
• Información general sobre el árbol de la UI Automation
• Utilizar el almacenamiento en caché en la automatización de la interfaz de usuario