MenuItem Clase

Definición

Representa un elemento individual que se muestra dentro de un control MainMenu o ContextMenu.Represents an individual item that is displayed within a MainMenu or ContextMenu. Aunque el control ToolStripMenuItem reemplaza y agrega funcionalidad al control MenuItem de las versiones anteriores, MenuItem se conserva a efectos de compatibilidad con versiones anteriores y uso futuro, si se desea.Although ToolStripMenuItem replaces and adds functionality to the MenuItem control of previous versions, MenuItem is retained for both backward compatibility and future use if you choose.

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.The following code example creates a menu structure for a form. El código de ejemplo agrega MenuItem un para representar el elemento de menú de nivel superior, le agrega un elemento de submenú 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.The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. El ejemplo requiere que haya un MainMenu objeto denominado mainMenu1 y menuItem2 menuItem4 menuItem1 MenuItemcuatroobjetos denominados, ,y.menuItem3The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and 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

Para que se muestre MenuItem un objeto, debe agregarlo a un MainMenu objeto o ContextMenu.In order for a MenuItem to be displayed, you must add it to a MainMenu or ContextMenu. Para crear submenús, puede agregar MenuItem objetos a la MenuItems propiedad del elemento primario MenuItem.To create submenus, you can add MenuItem objects to the MenuItems property of the parent MenuItem.

La MenuItem clase proporciona propiedades que le permiten configurar la apariencia y la funcionalidad de un elemento de menú.The MenuItem class provides properties that enable you to configure the appearance and functionality of a menu item. Para mostrar una marca de verificación junto a un elemento de menú, Checked use la propiedad.To display a check mark next to a menu item, use the Checked property. Puede usar esta característica para identificar un elemento de menú seleccionado en una lista de elementos de menú mutuamente excluyentes.You can use this feature to identify a menu item that is selected in a list of mutually exclusive menu items. Por ejemplo, si tiene un conjunto de elementos de menú para establecer el color del texto de un TextBox control, puede usar la Checked propiedad para identificar qué color está seleccionado actualmente.For example, if you have a set of menu items for setting the color of text in a TextBox control, you can use the Checked property to identify which color is currently selected. La Shortcut propiedad se puede utilizar para definir una combinación de teclas que se puede presionar para seleccionar el elemento de menú.The Shortcut property can be used to define a keyboard combination that can be pressed to select the menu item.

En MenuItem el caso de los objetos mostrados en una aplicación de interfaz de múltiples documentos ( MergeMenu MDI), puede usar el método para combinar los menús de un elemento primario MDI para con el de sus formularios secundarios con el fin de crear una estructura de menú consolidada.For MenuItem objects displayed in a Multiple Document Interface (MDI) application, you can use the MergeMenu method to merge the menus of an MDI parent for with that of its child forms to create a consolidated menu structure. MenuItem CloneMenu ContextMenu MainMenu Dado que nosepuedereutilizarenvariasubicacionesalmismotiempo,comoeny,puedeutilizarelmétodoparacrearunacopiadeunparasuusoenotraubicación.MenuItemBecause a MenuItem cannot be reused in multiple locations at the same time, such as in a MainMenu and a ContextMenu, you can use the CloneMenu method to create a copy of a MenuItem for use in another location.

El Popup evento le permite realizar tareas antes de que se muestre un menú.The Popup event enables you to perform tasks before a menu is displayed. Por ejemplo, puede crear un controlador de eventos para que este evento muestre u oculte los elementos de menú en función del estado del código.For example, you can create an event handler for this event to display or hide menu items based on the state of your code. El Select evento le 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ú.The Select event enables you to perform tasks such as providing detailed help for your application's menu items when the user places the mouse pointer over a menu item.

Constructores

MenuItem()

Inicializa una clase MenuItem con un título en blanco.Initializes a MenuItem with a blank caption.

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ú.Initializes a new instance of the MenuItem class with a specified caption; defined event-handlers for the Click, Select and Popup events; a shortcut key; a merge type; and order specified for the menu item.

MenuItem(String)

Inicializa una nueva instancia de la clase MenuItem con el título especificado para el elemento de menú.Initializes a new instance of the MenuItem class with a specified caption for the menu item.

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ú.Initializes a new instance of the class with a specified caption and event handler for the Click event of the menu item.

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ú.Initializes a new instance of the class with a specified caption, event handler, and associated shortcut key for the menu item.

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ú.Initializes a new instance of the class with a specified caption and an array of submenu items defined for the menu item.

Campos

FindHandle

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un identificador.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Heredado de Menu)
FindShortcut

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un acceso directo.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(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).Gets or sets a value indicating whether the MenuItem is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a submenu item or menu item displayed in a 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).Gets or sets a value indicating whether the item is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a menu item or submenu item displayed in a ContextMenu).

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(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ú.Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Heredado de Component)
DefaultItem

Obtiene o establece un valor que indica si el elemento de menú es el predeterminado.Gets or sets a value indicating whether the menu item is the default menu item.

DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Enabled

Obtiene o establece un valor que indica si el elemento de menú está habilitado.Gets or sets a value indicating whether the menu item is enabled.

Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Handle

Obtiene un valor que representa el identificador de ventana del menú.Gets a value representing the window handle for the menu.

(Heredado de Menu)
Index

Obtiene o establece un valor que indica la posición del elemento en el menú primario.Gets or sets a value indicating the position of the menu item in its parent menu.

IsParent

Obtiene un valor que indica si el elemento de menú contiene elementos de menú secundarios.Gets a value indicating whether the menu item contains child menu items.

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.Gets or sets a value indicating whether the menu item will be populated with a list of the Multiple Document Interface (MDI) child windows that are displayed within the associated form.

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).Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Heredado de Menu)
MenuID

Obtiene un valor que indica el identificador de Windows correspondiente a este elemento de menú.Gets a value indicating the Windows identifier for this menu item.

MenuItems

Obtiene un valor que indica la colección de objetos MenuItem asociados al menú.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Heredado de Menu)
MergeOrder

Obtiene o establece un valor que indica la posición relativa del elemento de menú cuando se combina con otro.Gets or sets a value indicating the relative position of the menu item when it is merged with another.

MergeType

Obtiene o establece un valor que indica el comportamiento del elemento de menú cuando su menú se combine con otro.Gets or sets a value indicating the behavior of this menu item when its menu is merged with another.

Mnemonic

Obtiene o establece un valor que indica el carácter de la tecla de acceso asociada a este elemento de menú.Gets a value indicating the mnemonic character that is associated with this menu item.

Name

Obtiene o establece el nombre de Menu.Gets or sets the name of the 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ú.Gets or sets a value indicating whether the code that you provide draws the menu item or Windows draws the menu item.

Parent

Obtiene un valor que indica el menú que contiene este elemento de menú.Gets a value indicating the menu that contains this menu item.

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.Gets or sets a value indicating whether the MenuItem, if checked, displays a radio-button instead of a check mark.

Shortcut

Obtiene o establece un valor que indica la tecla de método abreviado asociada al elemento de menú.Gets or sets a value indicating the shortcut key associated with the menu item.

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.Gets or sets a value indicating whether the shortcut key that is associated with the menu item is displayed next to the menu item caption.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
Tag

Obtiene o establece los datos definidos por el usuario asociados con el control.Gets or sets user-defined data associated with the control.

(Heredado de Menu)
Text

Obtiene o establece un valor que indica el título del elemento de menú.Gets or sets a value indicating the caption of the menu item.

Visible

Obtiene o establece un valor que indica si el elemento de menú es visible.Gets or sets a value indicating whether the menu item is visible.

Métodos

CloneMenu()

Crea una copia del objeto MenuItem actual.Creates a copy of the current MenuItem.

CloneMenu(Menu)

Copia el objeto Menu que se pasa como un parámetro al objeto Menu actual.Copies the Menu that is passed as a parameter to the current Menu.

(Heredado de Menu)
CloneMenu(MenuItem)

Crea una copia del objeto MenuItem especificado.Creates a copy of the specified MenuItem.

CreateMenuHandle()

Crea un nuevo identificador para Menu.Creates a new handle to the 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Se deshace de los recursos (distintos de la memoria) que usa MenuItem.Disposes of the resources (other than memory) used by the MenuItem.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FindMenuItem(Int32, IntPtr)

Obtiene el objeto MenuItem que contiene el valor especificado.Gets the MenuItem that contains the value specified.

(Heredado de Menu)
FindMergePosition(Int32)

Devuelve la posición en la que se debe insertar un elemento de menú.Returns the position at which a menu item should be inserted into the menu.

(Heredado de Menu)
GetContextMenu()

Obtiene el objeto ContextMenu que contiene este menú.Gets the ContextMenu that contains this menu.

(Heredado de Menu)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetMainMenu()

Obtiene el objeto MainMenu que contiene este menú.Gets the MainMenu that contains this menu.

(Heredado de Menu)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
MergeMenu()

Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(Menu)

Combina los objetos MenuItem de un menú en el menú actual.Merges the MenuItem objects of one menu with the current menu.

(Heredado de Menu)
MergeMenu(MenuItem)

Combina otro elemento de menú con éste.Merges another menu item with this menu item.

OnClick(EventArgs)

Genera el evento Click.Raises the Click event.

OnDrawItem(DrawItemEventArgs)

Genera el evento DrawItem.Raises the DrawItem event.

OnInitMenuPopup(EventArgs)

Genera el evento Popup.Raises the Popup event.

OnMeasureItem(MeasureItemEventArgs)

Genera el evento MeasureItem.Raises the MeasureItem event.

OnPopup(EventArgs)

Genera el evento Popup.Raises the Popup event.

OnSelect(EventArgs)

Genera el evento Select.Raises the Select event.

PerformClick()

Genera un evento Click para el objeto MenuItem mediante la simulación de un clic realizado por un usuario.Generates a Click event for the MenuItem, simulating a click by a user.

PerformSelect()

Provoca el evento Select para este elemento de menú.Raises the Select event for this menu item.

ProcessCmdKey(Message, Keys)

Procesa una tecla de comando.Processes a command key.

(Heredado de Menu)
ToString()

Devuelve una cadena que representa MenuItem.Returns a string that represents the 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.Occurs when the menu item is clicked or selected using a shortcut key or access key defined for the menu item.

Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(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ú.Occurs when the OwnerDraw property of a menu item is set to true and a request is made to draw the menu item.

MeasureItem

Se produce cuando el menú necesita saber el tamaño de un elemento de menú antes de dibujarlo.Occurs when the menu needs to know the size of a menu item before drawing it.

Popup

Se produce antes de que se muestre la lista de elementos de menú de un elemento.Occurs before a menu item's list of menu items is displayed.

Select

Se produce cuando el usuario coloca el puntero sobre un elemento de menú.Occurs when the user places the pointer over a menu item.

Se aplica a

Consulte también: