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.
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 proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft para el tipo de control Menu. Describe la estructura de árbol de Automatización de la interfaz de usuario de Microsoft del control y proporciona las propiedades y los patrones de control para escenarios de control específicos.
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 Menu. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de lista, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Estructura de árbol de automatización de la interfaz de usuario necesaria
En la tabla siguiente se muestra la vista de control y la 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 |
|---|---|
| Menú - MenuItem (1 o varios) |
No aplicable (a menos que el control de menú sea un menú contextual que sea primario de un objeto que no sea un elemento de menú). - MenuItem (1 o varios) |
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 tipos de control de menú deben aparecer bajo el control al que hace referencia su información. Los clientes de automatización de la interfaz de usuario deben escuchar MenuOpenedEvent 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. Aparecen como elementos secundarios del escritorio.
Propiedades necesarias de automatización de la interfaz de usuario
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 Propiedades de automatización de la interfaz de usuario para clientes.
| Propiedad de automatización de interfaz de usuario | Importancia | Notas |
|---|---|---|
| NameProperty | No está soportado | El control de menú no requiere que se establezca una propiedad Name. |
| LabeledByProperty | Null |
No se prevé ninguna etiqueta con un control de menú típico. |
| ControlTypeProperty | Menú | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| IsContentElementProperty | Falso | El control de menú no se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| IsControlElementProperty | Cierto | El control de menú siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario. |
Patrones de control de automatización de la interfaz de usuario necesarios
No hay patrones de control necesarios para el tipo de control Menu.
Eventos necesarios de automatización de la interfaz de usuario
Los controles de menú deben generarse MenuOpenedEvent cuando aparecen en la pantalla.
MenuOpenedEvent incluirá el texto del control.
MenuClosedEvent 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 deben admitir todos los controles de menú. Para más información sobre los eventos, vea UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Soporte técnico/valor | Notas |
|---|---|---|
| MenuOpenedEvent | Obligatorio | Ninguno |
| MenuClosedEvent | Obligatorio | Ninguno |
| BoundingRectangleProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| IsOffscreenProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| IsEnabledProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| AutomationFocusChangedEvent | Obligatorio | Ninguno |
| StructureChangedEvent | Obligatorio | Ninguno |