Compartir a través de


Compatibilidad de UI Automation para el tipo de control MenuBar

NotaNota

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 la UI Automation con el tipo de control MenuBar. En UI Automation, un tipo de control es un conjunto de condiciones que debe cumplir un control para utilizar la propiedad ControlTypeProperty. Las condiciones incluyen instrucciones específicas para la estructura de árbol de UI Automation, los valores de propiedades de UI Automation y los patrones de control.

Los controles de barra de menús son un ejemplo de controles que implementan el tipo de control MenuBar. Las barras de menús proporcionan un medio para que los usuarios activen los comandos y opciones contenidos en una aplicación.

Las secciones siguientes definen la estructura de árbol de UI Automation, las propiedades, los patrones de control y los eventos obligatorios para el tipo de control MenuBar. 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 interfaz de usuario obligatorias
  • Patrones de control de automatización de la interfaz de usuario obligatorios
  • Eventos de automatización de la interfaz de usuario obligatorios
  • Temas relacionados

Estructura de árbol de automatización de la interfaz de usuario obligatoria

En la tabla siguiente se muestran la vista de control y la vista de contenido del árbol UI Automation correspondiente a los controles de barra de menús 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

MenuBar

  • MenuItem (1 o más)

  • Otros controles (0 o muchos)

MenuBar

  • MenuItem (1 o más)

  • Otros controles (0 o muchos)

Los controles de barra de menús pueden contener otros controles, tales como controles de edición y cuadros combinados, dentro de su estructura. Estos controles adicionales corresponden a los "otros controles" mostrados anteriormente en las vistas de contenido y control.

Propiedades de automatización de la interfaz de usuario obligatorias

La tabla siguiente muestra la lista de propiedades de UI Automation cuyo valor o definición es especialmente relevante para los controles de barra de menús. 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

BoundingRectangleProperty

Vea las notas.

El valor expuesto por esta propiedad debe incluir todos los controles contenidos dentro de él.

NameProperty

Vea las notas.

El control de barra de menús no necesita un nombre a menos que una aplicación tenga más de una barra de menús. Si hay más de una barra de menús en una aplicación, es recomendable utilizar esta propiedad para exponer los nombres distintivos, tales como "Formato" o "Esquema."

LabeledByProperty

Null

Los controles de barra de menús nunca tienen etiqueta.

ControlTypeProperty

MenuBar

Este valor es el mismo para todos los marcos de trabajo de interfaz de usuario.

LocalizedControlTypeProperty

"barra de menús"

Cadena adaptada que corresponde al tipo de control MenuBar.

IsContentElementProperty

True

El control de barra de menús siempre está incluido en la vista de contenido del árbol de UI Automation.

IsControlElementProperty

True

El control de barra de menús siempre está incluido en la vista de control del árbol de UI Automation.

IsOffscreenProperty

Vea las notas.

El valor de esta propiedad depende de si el control está visible en la pantalla.

OrientationProperty

Depende

Esta propiedad expone si el control de barra de menús es horizontal o vertical.

IsKeyboardFocusableProperty

True

Los controles de barra de menús son enfocables mediante teclado, porque los controles que contienen pueden tomar el foco del teclado.

HelpTextProperty

Vea las notas.

No hay escenarios en los que se requiera texto de ayuda para un control de barra de menús.

AcceleratorKeyProperty

Null

Las barras de menús nunca tienen teclas de aceleración.

AccessKeyProperty

"ALT"

Al presionar la tecla ALT, el enfoque debe ir siempre a la barra de menús dentro de la aplicación.

Patrones de control de automatización de la interfaz de usuario obligatorios

La tabla siguiente muestra una lista de los patrones de control de UI Automation con los que deben ser compatibles todos los controles de barra de menús. Para obtener más información acerca de los patrones de control, vea Información general acerca de los patrones de control de automatización de la interfaz de usuario.

Patrón de control

Compatibilidad

Notas

IExpandCollapseProvider

Depende

Si el control se puede expandir o contraer, implemente IExpandCollapseProvider.

IDockProvider

Depende

Si el control se puede acoplar a diferentes partes de la pantalla, implemente IDockProvider.

ITransformProvider

Depende

Si el control puede cambiar de tamaño, girar o moverse, debe implementar ITransformProvider.

Eventos de automatización de la interfaz de usuario obligatorios

La tabla siguiente muestra una lista de los eventos de UI Automation con los que deben ser compatibles todos los controles de barra de menús. 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

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.

Necesario

Ninguno

Evento de cambio de propiedad de ExpandCollapseStateProperty.

Depende

Ninguno

AutomationFocusChangedEvent

Obligatorio

Ninguno

StructureChangedEvent

Obligatorio

Ninguno

Vea también

Referencia

MenuBar

Conceptos

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation