Compatibilidad de UI Automation para el tipo de control Menu
.gif "Nota") 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 proporciona información sobre la compatibilidad de Microsoft UI Automation con el tipo de control Menu. Se describe la estructura de árbol de Microsoft UI Automation del control y se proporcionan las propiedades y los patrones de control para los escenarios de control concretos.
Un control de menú permite organizar jerárquicamente los elementos asociada a comandos y controladores de eventos. En una aplicación típica de Microsoft Windows, una barra de menús contiene varios botones de menú (tales como Archivo, Edición y Ventana) y cada botón de menú muestra un menú. Un menú contiene una colección de elementos de menú (tales como Nuevo, Abrir y Cerrar), que se pueden expandir para mostrar los elementos de menú adicionales o realizar una acción concreta cuando se hace clic en ellos.
En las secciones siguientes se definen la estructura de árbol de UI Automation, las propiedades, los patrones de control y los eventos obligatorios para el tipo de control Menu. Los requisitos de UI Automation se aplican a todos los controles de lista, sean de Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Este tema contiene las secciones siguientes.
- Estructura de árbol de automatización de la interfaz de usuario obligatoria
- Propiedades de automatización de la IU obligatorias
- Patrones de control de automatización de la IU obligatorios
- Eventos de automatización de la IU obligatorios
- Temas relacionados
Estructura de árbol de automatización de la interfaz de usuario obligatoria
En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol UI Automation correspondiente a los controles de menú y se describe qué puede contener cada vista. Para obtener más información acerca del árbol de UI Automation, vea Información general sobre el árbol de la UI Automation.
Vista de control |
Vista de contenido |
|---|---|
Menu
|
No aplicable (a menos que el control Menu sea un menú contextual que sea el elemento primario de un objeto que no sea un elemento de menú)
|
Los controles de menú siempre aparecen en la vista de control y en la vista de contenido del árbol de UI Automation. Los tipos de control Menu deben aparecer bajo el control al que hace referencia su información. Los clientes de Automatización de la interfaz de usuario deben realizar escuchas para detectar MenuOpenedEvent, a fin de asegurarse de obtener de manera uniforme la información transmitida por los controles de menú. Los controles de menú contextual son un caso especial. Aparecen como elementos secundarios del Escritorio.
Propiedades de automatización de la IU obligatorias
En la tabla siguiente se muestra la lista de propiedades de UI Automation cuyo valor o definición es especialmente relevante para el tipo de control Menu. Para obtener más información acerca de las propiedades de UI Automation, vea Propiedades de UI Automation para clientes.
Propiedad de UI Automation |
Valor |
Notas |
|---|---|---|
No compatible |
El control de menú no exige establecer una propiedad Name. |
|
Null |
No se prevé ninguna etiqueta con un control Menu típico. |
|
Menu |
Este valor es el mismo para todos los marcos de trabajo de interfaz de usuario. |
|
False |
El control de menú no se incluye en la vista de contenido del árbol de UI Automation. |
|
True |
El control de menú siempre se incluye en la vista de control del árbol de UI Automation. |
Patrones de control de automatización de la IU obligatorios
No hay ningún patrón de control necesario para el tipo de control Menu.
Eventos de automatización de la IU obligatorios
Los controles de menú deben provocar un evento MenuOpenedEvent cuando aparecen en la pantalla. MenuOpenedEvent incluirá el texto del control. El evento MenuClosedEvent se debe provocar cuando un menú desaparece en la pantalla.
En la tabla siguiente se muestra una lista de los eventos de UI Automation con los que deben ser compatibles todos los controles de menú. Para obtener más información sobre los eventos, vea Información general sobre eventos de UI Automation.
Evento de UI Automation |
Compatibilidad/valor |
Notas |
|---|---|---|
Obligatorio |
Ninguno |
|
Obligatorio |
Ninguno |
|
Evento de cambio de propiedad de BoundingRectangleProperty. |
Obligatorio |
Ninguno |
Evento de cambio de propiedad de IsOffscreenProperty. |
Necesario |
Ninguno |
Evento de cambio de propiedad de IsEnabledProperty. |
Obligatorio |
Ninguno |
Obligatorio |
Ninguno |
|
Obligatorio |
Ninguno |
Vea también
Referencia
Conceptos
Información general acerca de los patrones de control de automatización de la interfaz de usuario