Compartir a través de

MenuItem

El MenuItem control representa elementos seleccionables individuales dentro de un Menu o un ContextMenu. MenuItem es el bloque de creación fundamental de los sistemas de menús en aplicaciones WPF, proporcionando los elementos interactivos que los usuarios hacen clic o seleccionan para realizar acciones.

Captura de pantalla que muestra un control Menu con varios controles MenuItem.

Para obtener ejemplos sobre el uso de menús, vea Menú: Exmaples.

Menu actúa como contenedor para MenuItem objetos, estableciendo una relación de elementos primarios y secundarios donde:

  • El control Menú proporciona la estructura general y el diseño para organizar los elementos de menú.
  • Cada menuItem representa un comando, opción o submenú específico dentro de esa estructura.
  • MenuItems puede contener otros elementos MenuItems como elementos secundarios, creando submenús jerárquicos de profundidad ilimitada.
  • MenuItems hereda las propiedades de estilo y comportamiento de su menú primario a menos que se invalide explícitamente.

Esta relación jerárquica permite crear estructuras de navegación complejas, desde menús planos sencillos hasta sistemas submenú profundamente anidados.

MenuItems admite varios tipos diferentes de comportamientos:

Elementos de comando: MenuItems que ejecutan comandos específicos al hacer clic en él. Normalmente se usan para acciones como Abrir archivo > o Editar > copia.

Elementos seleccionables: Elementos del menú que se pueden activar y desactivar, similares a casillas de verificación. Establezca la IsCheckable propiedad en true para habilitar este comportamiento.

Elementos separadores: Use Separator controles dentro de un Menú para agrupar visualmente MenuItems relacionados.

Elementos de submenú: MenuItems que contienen otros MenuItems como elementos secundarios. Al hacer clic o mantener el puntero, muestran un submenú con opciones adicionales.

Entre las propiedades clave de MenuItem se incluyen:

  • Header: el contenido que se muestra en el elemento de menú.
  • Command: comando que se va a ejecutar cuando se selecciona el elemento.
  • IsCheckable: indica si el elemento se puede comprobar y desactivar.
  • IsChecked: estado comprobado actual de un elemento comprobable.
  • InputGestureText: texto que representa el método abreviado de teclado del elemento.
  • Icon: icono que se va a mostrar junto con el texto del elemento de menú.

Entre los eventos importantes se incluyen Click, Checkedy Unchecked.

Estilos y plantillas

Puede modificar el valor predeterminado ControlTemplate para dar al MenuItem control una apariencia única. Para obtener más información, vea ¿Qué son los estilos y las plantillas? yCómo crear una plantilla para un control.

Content (propiedad)

Este control no define una propiedad de contenido.

Partes

En la tabla siguiente se enumeran las partes con nombre para el MenuItem control .

Parte Tipo Description
PART_Popup Popup Ventana emergente que contiene los elementos de submenú.

Cuando se crea un ControlTemplate para un MenuItem, la plantilla podría contener un ItemsPresenter dentro de un ScrollViewer. ItemsPresenter muestra cada elemento de MenuItem; el ScrollViewer habilita el desplazamiento dentro del control . Si ItemsPresenter no es un elemento secundario directo de ScrollViewer, debe darle al ItemsPresenter el nombre ItemsPresenter.

Estados visuales

En la tabla siguiente se enumeran los estados visuales del MenuItem control.

Nombre de VisualState Nombre de VisualStateGroup Description
Validar Estados de Validación El control es válido y no tiene errores de validación.
EnfoqueInválido Estados de Validación El control tiene un error de validación y tiene el foco del teclado.
InválidoSinEnfoque Estados de Validación El control presenta un error de validación, pero no tiene el enfoque del teclado.

Consulte también

  • Last updated on