MenuItem Clase

Definición

Representa un elemento individual que se muestra dentro de un control MainMenu o ContextMenu.

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Use ToolStripMenuItem en su lugar, que reemplaza el MenuItem control .

public ref class MenuItem : System::Windows::Forms::Menu
public class MenuItem : System.Windows.Forms.Menu
type MenuItem = class
    inherit Menu
Public Class MenuItem
Inherits Menu
Herencia

Ejemplos

En el ejemplo de código siguiente se crea una estructura de menú para un formulario. El código de ejemplo agrega un MenuItem objeto para representar el elemento de menú de nivel superior, agrega un elemento de submenú a él para seleccionar un tamaño de fuente y, a continuación, agrega dos elementos de submenú a ese elemento de menú que representan opciones de fuente grandes y pequeñas en una aplicación. En el ejemplo se requiere que haya un MainMenu objeto denominado mainMenu1 y cuatro MenuItem objetos denominados menuItem1, menuItem2, menuItem3y menuItem4.

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }
public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }
Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Comentarios

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Utilice ToolStripMenuItem en su lugar.

Para que se muestre un MenuItem objeto , debe agregarlo a o MainMenuContextMenu. Para crear submenús, puede agregar MenuItem objetos a la MenuItems propiedad del elemento primario MenuItem.

La MenuItem clase proporciona propiedades que permiten configurar la apariencia y la funcionalidad de un elemento de menú. Para mostrar una marca de verificación junto a un elemento de menú, use la Checked propiedad . Puede usar esta característica para identificar un elemento de menú seleccionado en una lista de elementos de menú mutuamente excluyentes. Por ejemplo, si tiene un conjunto de elementos de menú para establecer el color del texto en un TextBox control, puede usar la Checked propiedad para identificar qué color está seleccionado actualmente. La Shortcut propiedad se puede usar para definir una combinación de teclado que se puede presionar para seleccionar el elemento de menú.

En MenuItem el caso de los objetos que se muestran en una aplicación de interfaz de varios documentos (MDI), puede usar el MergeMenu método para combinar los menús de un elemento primario MDI para con el de sus formularios secundarios para crear una estructura de menú consolidada. Dado que no se puede reutilizar en MenuItem varias ubicaciones al mismo tiempo, como en MainMenu y , ContextMenupuede usar el CloneMenu método para crear una copia de para MenuItem su uso en otra ubicación.

El Popup evento permite realizar tareas antes de que se muestre un menú. Por ejemplo, puede crear un controlador de eventos para este evento para mostrar u ocultar elementos de menú en función del estado del código. El Select evento permite realizar tareas como proporcionar ayuda detallada para los elementos de menú de la aplicación cuando el usuario coloca el puntero del mouse sobre un elemento de menú.

Constructores

MenuItem()

Inicializa una clase MenuItem con un título en blanco.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inicializa una nueva instancia de la clase MenuItem con un título especificado, los controladores de los eventos Click, Select y Popup definidos, una tecla de método abreviado, un tipo de combinación y un orden especificados para el elemento de menú.

MenuItem(String)

Inicializa una nueva instancia de la clase MenuItem con el título especificado para el elemento de menú.

MenuItem(String, EventHandler)

Inicializa una nueva instancia de la clase con el título especificado y un controlador de eventos para el evento Click del elemento de menú.

MenuItem(String, EventHandler, Shortcut)

Inicializa una nueva instancia de la clase con el título, el controlador de eventos y la tecla de método abreviado especificados para el elemento de menú.

MenuItem(String, MenuItem[])

Inicializa una nueva instancia de la clase con el título especificado y una matriz de elementos de submenú definidos para el elemento de menú.

Campos

FindHandle

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un identificador.

(Heredado de Menu)
FindShortcut

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un acceso directo.

(Heredado de Menu)

Propiedades

BarBreak

Obtiene o establece un valor que indica si el objeto MenuItem se coloca en una nueva línea (para elementos de menú agregados a un objeto MainMenu) o en una nueva columna (para elementos de menú o de submenú mostrados en un objeto ContextMenu).

Break

Obtiene o establece un valor que indica si el elemento se coloca en una nueva línea (para elementos de menú agregados a un objeto MainMenu) o en un nueva columna (para elementos de menú o de submenú mostrados en un objeto ContextMenu).

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.

(Heredado de Component)
Checked

Obtiene o establece un valor que indica si se va a mostrar una marca de verificación junto al texto del elemento de menú.

Container

Obtiene la interfaz IContainer que contiene la clase Component.

(Heredado de Component)
DefaultItem

Obtiene o establece un valor que indica si el elemento de menú es el predeterminado.

DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.

(Heredado de Component)
Enabled

Obtiene o establece un valor que indica si el elemento de menú está habilitado.

Events

Obtiene la lista de controladores de eventos asociados a Component.

(Heredado de Component)
Handle

Obtiene un valor que representa el identificador de ventana del menú.

(Heredado de Menu)
Index

Obtiene o establece un valor que indica la posición del elemento en el menú primario.

IsParent

Obtiene un valor que indica si el elemento de menú contiene elementos de menú secundarios.

MdiList

Obtiene o establece un valor que indica si el elemento de menú se llenará con una lista de las ventanas secundarias de Interfaz de múltiples documentos (MDI) que se muestran dentro del formulario asociado.

MdiListItem

Obtiene un valor que indica la clase MenuItem que se utiliza para mostrar una lista de formularios secundarios de interfaz de múltiples documentos (MDI).

(Heredado de Menu)
MenuID

Obtiene un valor que indica el identificador de Windows correspondiente a este elemento de menú.

MenuItems

Obtiene un valor que indica la colección de objetos MenuItem asociados al menú.

(Heredado de Menu)
MergeOrder

Obtiene o establece un valor que indica la posición relativa del elemento de menú cuando se combina con otro.

MergeType

Obtiene o establece un valor que indica el comportamiento del elemento de menú cuando su menú se combine con otro.

Mnemonic

Obtiene o establece un valor que indica el carácter de la tecla de acceso asociada a este elemento de menú.

Name

Obtiene o establece el nombre de Menu.

(Heredado de Menu)
OwnerDraw

Obtiene o establece un valor que indica si es el código proporcionado o Windows quien dibuja el elemento de menú.

Parent

Obtiene un valor que indica el menú que contiene este elemento de menú.

RadioCheck

Obtiene o establece un valor que indica si el objeto MenuItem mostrará un botón de opción en lugar de una marca de verificación cuando esté seleccionado.

Shortcut

Obtiene o establece un valor que indica la tecla de método abreviado asociada al elemento de menú.

ShowShortcut

Obtiene o establece un valor que indica si la tecla de método abreviado asociada al elemento de menú aparecerá junto al título del mismo.

Site

Obtiene o establece ISite de Component.

(Heredado de Component)
Tag

Obtiene o establece los datos definidos por el usuario asociados con el control.

(Heredado de Menu)
Text

Obtiene o establece un valor que indica el título del elemento de menú.

Visible

Obtiene o establece un valor que indica si el elemento de menú es visible.

Métodos

CloneMenu()

Crea una copia del objeto MenuItem actual.

CloneMenu(Menu)

Copia el objeto Menu que se pasa como un parámetro al objeto Menu actual.

(Heredado de Menu)
CloneMenu(MenuItem)

Crea una copia del objeto MenuItem especificado.

CreateMenuHandle()

Crea un nuevo identificador para Menu.

(Heredado de Menu)
CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.

(Heredado de Component)
Dispose(Boolean)

Se deshace de los recursos (distintos de la memoria) que usa MenuItem.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindMenuItem(Int32, IntPtr)

Obtiene el objeto MenuItem que contiene el valor especificado.

(Heredado de Menu)
FindMergePosition(Int32)

Devuelve la posición en la que se debe insertar un elemento de menú.

(Heredado de Menu)
GetContextMenu()

Obtiene el objeto ContextMenu que contiene este menú.

(Heredado de Menu)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetMainMenu()

Obtiene el objeto MainMenu que contiene este menú.

(Heredado de Menu)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
MergeMenu()

Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.

MergeMenu(Menu)

Combina los objetos MenuItem de un menú en el menú actual.

(Heredado de Menu)
MergeMenu(MenuItem)

Combina otro elemento de menú con éste.

OnClick(EventArgs)

Genera el evento Click.

OnDrawItem(DrawItemEventArgs)

Genera el evento DrawItem.

OnInitMenuPopup(EventArgs)

Genera el evento Popup.

OnMeasureItem(MeasureItemEventArgs)

Genera el evento MeasureItem.

OnPopup(EventArgs)

Genera el evento Popup.

OnSelect(EventArgs)

Genera el evento Select.

PerformClick()

Genera un evento Click para el objeto MenuItem mediante la simulación de un clic realizado por un usuario.

PerformSelect()

Provoca el evento Select para este elemento de menú.

ProcessCmdKey(Message, Keys)

Procesa una tecla de comando.

(Heredado de Menu)
ToString()

Devuelve una cadena que representa MenuItem.

Eventos

Click

Se produce al hacer clic en el elemento de menú o seleccionarlo mediante una tecla de método abreviado o una tecla de acceso definida para ese elemento.

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().

(Heredado de Component)
DrawItem

Se produce cuando la propiedad OwnerDraw de un elemento del menú se establece en true y se realiza una solicitud para dibujar el elemento del menú.

MeasureItem

Se produce cuando el menú necesita saber el tamaño de un elemento de menú antes de dibujarlo.

Popup

Se produce antes de que se muestre la lista de elementos de menú de un elemento.

Select

Se produce cuando el usuario coloca el puntero sobre un elemento de menú.

Se aplica a

Consulte también