Tipo de control menu

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Menu.

Un control de menú permite organizar jerárquicamente los elementos asociados a comandos y controladores de eventos. En una aplicación típica de Microsoft Windows, una barra de menú contiene varios botones de menú (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ú (como Nuevo, Abriry Cerrar), que se puede expandir para mostrar elementos de menú adicionales o realizar una acción específica cuando se haga clic en ellos.

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 Menu. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de menú 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

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 menú 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
  • Menú
    • MenuItem (1 o varios)
    • Otros controles (0 o varios)
  • Menú
    • MenuItem (1 o varios)
    • Otros controles (0 o varios)

 

Los controles de menú siempre aparecen en las vistas de control y contenido del árbol de UI Automation. Los controles de menú deben aparecer bajo el control al que hace referencia su información. Automatización de la interfaz de usuario los clientes pueden escuchar UIA_MenuOpenedEventId para asegurarse de que obtienen de forma coherente la información transmitida por los controles de menú. Los controles de menú contextual son un caso especial. Pueden aparecer como elementos secundarios del escritorio o de una ventana de aplicación de nivel superior.

Un control de menú puede contener otros controles, como controles de edición y cuadros combinados, dentro de su estructura. Estos controles adicionales corresponden a los "otros controles" enumerados en la tabla anterior en las vistas de control y contenido.

Propiedades pertinentes

En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para el tipo de control Menu. 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_ControlTypePropertyId Menú
UIA_IsContentElementPropertyId TRUE El control de menú siempre se incluye en la vista de contenido del árbol de Automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId TRUE El control de menú siempre se incluye en la vista de control del árbol de UI Automation.
UIA_LabeledByPropertyId NULL No se espera ninguna etiqueta con un control de menú típico.
UIA_NamePropertyId Vea las notas. El control de menú no requiere que se establezca una propiedad Name o podría tener el mismo nombre que el control asociado, como un elemento de menú que abrió el submenú.

 

Patrones de control necesarios

No hay ningún patrón de control necesario para el tipo de control Menu.

Eventos necesarios

Los controles de menú deben generar el evento UIA_MenuOpenedEventId cuando aparezcan en la pantalla. El evento UIA_MenuOpenedEventId incluirá el texto del control. El evento UIA_MenuClosedEventId debe generarse cuando un menú desaparece de la pantalla.

En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que los controles de menú son necesarios 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_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_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation