MenuItem Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object

MarshalByRefObject

Component

Menu
MenuItem

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 MainMenu ContextMenu. 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

Compartir a través de