Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft para el tipo de control menú de.
Un control de menú permite la organización jerárquica de elementos asociados 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ú (como Archivo, Editary 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 pueden expandir para mostrar elementos de menú adicionales o para realizar una acción específica cuando se hace clic en él.
En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control menú de. 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 integra la compatibilidad de automatización de la interfaz de usuario con los tipos de control y los patrones de control.
Este tema contiene las secciones siguientes.
- estructura de árbol típica
- de 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 menú y se describe lo que se puede contener en cada vista. Para obtener más información sobre el árbol de automatización de la interfaz de usuario, consulte Introducción al árbol de automatización de la interfaz de usuario.
| Vista de control | Vista de contenido |
|---|---|
|
|
Los controles de menú siempre aparecen en la vista de control y en la vista de contenido del árbol de automatización de la interfaz de usuario. Los controles de menú deben aparecer bajo el control al que hace referencia su información. Los clientes de automatización de la interfaz de usuario pueden escuchar UIA_MenuOpenedEventId para asegurarse de que obtienen información transmitida de forma coherente 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 de 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, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.
| Ui Automation (propiedad) | Valor | Notas |
|---|---|---|
| UIA_ControlTypePropertyId | menú de | |
| UIA_IsContentElementPropertyId | VERDADERO | El control de menú siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| UIA_IsControlElementPropertyId | VERDADERO | El control de menú siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario. |
| UIA_LabeledByPropertyId | NULO | No se prevé 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 patrones de control necesarios para el tipo de control Menu.
Eventos necesarios
Los controles de menú deben generar el evento UIA_MenuOpenedEventId cuando aparecen 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 de automatización de la interfaz de usuario que son necesarios para admitir los controles de menú. Para obtener más información sobre los eventos, consulte 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 propiedadIsEnabled, 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 |
Temas relacionados
-
conceptual de
-
Introducción a los tipos de control de automatización de la interfaz de usuario de
-
información general de automatización de la interfaz de usuario de