Implementar el patrón de control Window 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.

En este tema se presentan las directrices y convenciones de implementación de IWindowProvider, incluida información acerca de las propiedades, los métodos y los eventos de WindowPattern. Los vínculos a referencias adicionales se enumeran al final del tema.

El patrón de control WindowPattern se usa para admitir controles que proporcionan funcionalidad fundamental de Windows en una graphical user interface (GUI) tradicional. Algunos ejemplos de controles que deben implementar este patrón de control son las ventanas de la aplicación de nivel superior, las ventanas secundarias de multiple-document interface (MDI), los controles de panel dividido de tamaño variable, los cuadros de diálogo modales y las ventanas de globo de ayuda.

Este tema contiene las secciones siguientes.

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

Directrices y convenciones de implementación

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

Para admitir la funcionalidad de modificar el tamaño y la posición en pantalla de la ventana mediante automatización de la interfaz de usuario, un control debe implementar ITransformProvider además de IWindowProvider.
Normalmente, los controles que contienen barras de título y elementos de barra de título que permiten mover, cambiar de tamaño, maximizar, minimizar o cerrar el control deben implementar IWindowProvider.
Los controles como los elementos emergentes de la información sobre herramientas y los elementos desplegables de menús y cuadros combinados normalmente no implementan IWindowProvider.
Las ventanas de globo de ayuda se diferencian de los elementos emergentes de información sobre herramientas básicos porque incluyen un botón Cerrar que se parece a una ventana.
IWindowProvider no admite el modo de pantalla completa porque es específico de la característica de una aplicación y no es un comportamiento típico de una ventana.

Miembros necesarios para IWindowProvider

Las propiedades, los métodos y los eventos siguientes son necesarios para la interfaz IWindowProvider.

Miembro obligatorio	Tipo de miembro	Notas
InteractionState	Propiedad	Ninguno
IsModal	Propiedad	Ninguno
IsTopmost	Propiedad	Ninguno
Maximizable	Propiedad	Ninguno
Minimizable	Propiedad	Ninguno
VisualState	Propiedad	Ninguno
Close	Método	Ninguno
SetVisualState	Método	Ninguno
WaitForInputIdle	Método	Ninguno
WindowClosedEvent	Evento	Ninguno
WindowOpenedEvent	Evento	Ninguno
WindowInteractionState	Evento	No se garantiza que sea ReadyForUserInteraction

Excepciones

Los proveedores deben iniciar las excepciones siguientes.

Tipo de excepción	Condition
InvalidOperationException	SetVisualState Cuando un control no admite un comportamiento solicitado.
ArgumentOutOfRangeException	WaitForInputIdle Cuando el parámetro no es un número válido.

InvalidOperationException

SetVisualState