Implementación del patrón de control de transformación para la automatización de la interfaz de usuario

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 ITransformProvider, incluida información sobre propiedades, métodos y eventos. Los vínculos a referencias adicionales se enumeran al final del tema.

El TransformPattern patrón de control se usa para admitir controles que se pueden mover, cambiar de tamaño o girar dentro de un espacio bidimensional. 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.

Directrices y convenciones de implementación

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

• La compatibilidad con este patrón de control no se limita a los objetos del escritorio. Este patrón de control también debe ser compatible con los elementos secundarios de un objeto contenedor si los elementos secundarios se pueden mover, cambiar de tamaño o girar libremente dentro de los límites del contenedor.

• No se puede mover, cambiar el tamaño o girar un objeto de modo que su ubicación de pantalla resultante estaría completamente fuera de las coordenadas de su contenedor y, por tanto, inaccesible para el teclado o el mouse (por ejemplo, cuando una ventana de nivel superior se mueve fuera de la pantalla o un objeto secundario se mueve fuera de los límites de la ventanilla del contenedor). En estos casos, el objeto se coloca lo más cerca posible de las coordenadas de pantalla solicitadas con las coordenadas superior o izquierda invalidada para estar dentro de los límites del contenedor.

• En el caso de los sistemas de varios monitores, si un objeto se mueve, cambia de tamaño o gira completamente fuera de las coordenadas combinadas de la pantalla de escritorio, el objeto se coloca en el monitor principal lo más cerca posible de las coordenadas solicitadas.

• Todos los parámetros y valores de propiedad son absolutos e independientes de la configuración regional.

Miembros necesarios para ITransformProvider

Se requieren las siguientes propiedades y métodos para implementar ITransformProvider.

Miembros necesarios	Tipo de miembro	Notas
CanMove	Propiedad	Ninguno
CanResize	Propiedad	Ninguno
CanRotate	Propiedad	Ninguno
Move	Método	Ninguno
Resize	Método	Ninguno
Rotate	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	Move - Si el CanMoveProperty es falso.
InvalidOperationException	Resize - Si el CanResizeProperty es falso.
InvalidOperationException	Rotate - Si el CanRotateProperty es falso.

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