Tipo de control Window
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Window.
El control de ventana consta del marco de la ventana, que contiene objetos secundarios como la barra de título, el cliente y otros objetos.
En las secciones siguientes se definen la estructura de árbol Automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control Window. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de ventana en los que el marco o la plataforma de la interfaz de usuario se integra Automatización de la interfaz de usuario compatibilidad con los tipos de control y los patrones de control.
En este tema se incluyen las siguientes secciones.
- Estructura de árbol típica
- Propiedades pertinentes
- Patrones de control necesarios
- Eventos necesarios
- Temas relacionados
Estructura de árbol típica
En la tabla siguiente se muestra un control típico y una vista de contenido del árbol de Automatización de la interfaz de usuario que pertenece a los controles de ventana y se describe lo que se puede contener en cada vista. Para más información sobre el árbol de UI Automation, vea Información general del árbol de UI Automation.
Vista de control | Vista de contenido |
---|---|
|
|
Propiedades pertinentes
En la tabla siguiente se muestran las propiedades de Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de ventana. Para obtener más información sobre las propiedades de Automatización de la interfaz de usuario, vea Recuperar propiedades de Automatización de la interfaz de usuario Elements.
Propiedad de automatización de interfaz de usuario | Valor | Notas |
---|---|---|
UIA_AutomationIdPropertyId | Vea las notas. | El valor de esta propiedad debe ser único entre todos los elementos del mismo nivel en la vista sin procesar del árbol de Automatización de la interfaz de usuario. |
UIA_BoundingRectanglePropertyId | Vea las notas. | El rectángulo exterior que contiene el control completo. |
UIA_ClickablePointPropertyId | Vea las notas. | El control de ventana debe tener un punto en el que se pueda hacer clic que haga que la ventana se seleccione o no esté seleccionada. |
UIA_ControlTypePropertyId | Ventana | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
UIA_IsContentElementPropertyId | TRUE | El control de ventana siempre se incluye en la vista de contenido del árbol de Automatización de la interfaz de usuario. |
UIA_IsControlElementPropertyId | TRUE | El control de ventana siempre se incluye en la vista de control del árbol de Automatización de la interfaz de usuario. |
UIA_IsKeyboardFocusablePropertyId | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
UIA_LabeledByPropertyId | NULL | Los controles de ventana no tienen una etiqueta de ventana estática. |
UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control Window . El valor predeterminado es "window" para en-US o inglés (Estados Unidos). |
UIA_NamePropertyId | Vea las notas. | El control de ventana siempre contiene un elemento de ventana principal relacionado con lo que el usuario asociaría como el identificador más semántico del elemento. |
Patrones de control necesarios
En la tabla siguiente se muestran los patrones de control de Automatización de la interfaz de usuario requeridos para ser admitidos por los controles de ventana. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
Patrón de control/Propiedad de patrón | Soporte técnico/valor | Notas |
---|---|---|
IDockProvider | Condicional | El patrón de control Dock debe admitirse si se puede acoplar la ventana. |
ITransformProvider | Obligatorio | El patrón de control Transformar permite mover, cambiar de tamaño o girar la ventana en la pantalla. (No se aplica a las aplicaciones de la Tienda Windows). |
IWindowProvider | Obligatorio | El patrón de control Window habilita operaciones específicas para la ventana. |
Eventos necesarios
En la tabla siguiente se enumeran los eventos de Automatización de la interfaz de usuario que se requieren los controles Window para admitir. Para más información sobre los eventos, vea UI Automation Events Overview.
Evento de Automatización de la interfaz de usuario | Notas |
---|---|
UIA_AsyncContentLoadedEventId | |
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId evento de cambio de propiedad. | |
UIA_IsEnabledPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsEnabled , debe admitir este evento. |
UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen , debe admitir este evento. |
UIA_LayoutInvalidatedEventId | |
UIA_NamePropertyId evento de cambio de propiedad. | |
UIA_ScrollHorizontallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_ScrollHorizontalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_ScrollHorizontalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_ScrollVerticallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_ScrollVerticalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_ScrollVerticalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
UIA_StructureChangedEventId | |
UIA_Window_WindowClosedEventId | |
UIA_Window_WindowOpenedEventId | |
UIA_WindowWindowVisualStatePropertyId evento de cambio de propiedad. | Si el control admite la propiedad WindowVisualState del patrón de control Window , este evento debe admitirse. |
Temas relacionados
-
Conceptual