Compartir a través de

Implementación del patrón de control de ventanas para la automatización de UI

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

El WindowPattern patrón de control se usa para admitir controles que proporcionan funcionalidad fundamental basada en ventanas dentro de una interfaz gráfica de usuario (GUI) tradicional. Entre los ejemplos de controles que deben implementar este patrón de control se incluyen ventanas de aplicación de nivel superior, ventanas secundarias de interfaz de varios documentos (MDI), controles de panel dividido de tamaño ajustable, cuadros de diálogo modales y ventanas de ayuda de globo.

Directrices y convenciones de implementación

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

  • Para admitir la capacidad de modificar el tamaño de ventana y la posición de la pantalla mediante la automatización de la interfaz de usuario, un control debe implementarse ITransformProvider además de IWindowProvider.

  • Los controles que contienen barras de título y elementos de barra de título que permiten mover el control, cambiar el tamaño, maximizar, minimizar o cerrar suelen ser necesarios para implementar IWindowProvider.

  • Los controles como los elementos emergentes de información sobre herramientas y las listas desplegables de menús o cuadros combinados normalmente no implementan IWindowProvider.

  • Las ventanas de ayuda con globos se diferencian de las ventanas emergentes simples porque incluyen un botón de cerrar similar al de una ventana.

  • IWindowProvider no admite el modo de pantalla completa, ya que es específico de las características de una aplicación y no es un comportamiento típico de la ventana.

Miembros necesarios para IWindowProvider

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

Miembro requerido 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 producir las siguientes excepciones.

Tipo de excepción Condición
InvalidOperationException SetVisualState

- Cuando un control no admite un comportamiento solicitado.
ArgumentOutOfRangeException WaitForInputIdle

- Cuando el parámetro no es un número válido.

Consulte también