MenuItem MenuItem MenuItem MenuItem Constructors

Definición

Sobrecargas

MenuItem() MenuItem() MenuItem()

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

MenuItem(String) MenuItem(String) MenuItem(String) 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) MenuItem(String, EventHandler) MenuItem(String, EventHandler) 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, MenuItem[]) MenuItem(String, MenuItem[]) MenuItem(String, MenuItem[]) 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.

MenuItem(String, EventHandler, Shortcut) MenuItem(String, EventHandler, Shortcut) 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(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[]) MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[]) 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() MenuItem() MenuItem()

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

public:
 MenuItem();
public MenuItem ();
Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se crea un MenuItem con esta versión del constructor.The following code example creates a MenuItem using this version of the constructor.

public:
   void CreateMyMenu()
   {
      // Create an empty menu item object.
      MenuItem^ menuItem1 = gcnew MenuItem;
      // Intialize the menu item using the parameterless version of the constructor.
      // Set the caption of the menu item.
      menuItem1->Text = "&File";
   }
public void CreateMyMenu()
{
   // Create an empty menu item object.
   MenuItem menuItem1 = new MenuItem();
   // Intialize the menu item using the parameterless version of the constructor.
   // Set the caption of the menu item.
   menuItem1.Text = "&File";
}

Public Sub CreateMyMenu()
    ' Create an empty menu item object.
    Dim menuItem1 As New MenuItem()
    ' Intialize the menu item using the parameterless version of the constructor.
    ' Set the caption of the menu item.
    menuItem1.Text = "&File"
End Sub

Comentarios

Una vez haya creado un espacio en blanco MenuItem utilizando este constructor, puede usar las propiedades y métodos de la MenuItem clase para especificar la apariencia y comportamiento de su MenuItem.Once you have created a blank MenuItem using this constructor, you can use the properties and methods of the MenuItem class to specify the appearance and behavior of your MenuItem.

MenuItem(String) MenuItem(String) MenuItem(String) 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.

public:
 MenuItem(System::String ^ text);
public MenuItem (string text);
new System.Windows.Forms.MenuItem : string -> System.Windows.Forms.MenuItem
Public Sub New (text As String)

Parámetros

text
String String String String

Título del elemento de menú.The caption for the menu item.

Ejemplos

En el ejemplo de código siguiente se crea un MenuItem que especifica el título del elemento de menú en el momento en que se construye.The following code example creates a MenuItem that specifies the caption of the menu item at the time it is constructed.

public:
   void CreateMyMenus()
   {
      // Create an instance of a MenuItem with a specified caption.
      menuItem1 = gcnew MenuItem( "&File" );
   }
public void CreateMyMenus()
{
   // Create an instance of a MenuItem with a specified caption.
   menuItem1 = new MenuItem("&File");
}

Public Sub CreateMyMenus()
    ' Create an instance of a MenuItem with a specified caption.
    menuItem1 = New MenuItem("&File")
End Sub

Comentarios

Cuando se especifica un título para el elemento de menú con el text parámetro, también puede especificar una clave de acceso mediante la colocación de un carácter '&' antes del carácter que se usará como la clave de acceso.When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' character before the character to be used as the access key. Por ejemplo, para especificar la "F" en "File" como una clave de acceso, podría especificar el título del elemento de menú como "& archivo".For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". Puede usar esta característica para proporcionar navegación mediante el teclado para los menús.You can use this feature to provide keyboard navigation for your menus.

Establecer el text parámetro a "-" hace que el elemento de menú se muestre como un separador (una línea horizontal) en lugar de un elemento de menú estándar.Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

MenuItem(String, EventHandler) MenuItem(String, EventHandler) MenuItem(String, EventHandler) 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.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick);
public MenuItem (string text, EventHandler onClick);
new System.Windows.Forms.MenuItem : string * EventHandler -> System.Windows.Forms.MenuItem
Public Sub New (text As String, onClick As EventHandler)

Parámetros

text
String String String String

Título del elemento de menú.The caption for the menu item.

onClick
EventHandler EventHandler EventHandler EventHandler

EventHandler que trata el evento Click para este elemento de menú.The EventHandler that handles the Click event for this menu item.

Ejemplos

En el ejemplo de código siguiente se crea un MenuItem objeto con el título especificado y un EventHandler delegado conectado a un controlador de eventos que se va a controlar el Click eventos para el elemento de menú.The following code example creates a MenuItem object with a specified caption and an EventHandler delegate connected to an event handler that will handle the Click event for the menu item.

public:
   void CreateMyMenuItem()
   {
      // Create an instance of MenuItem with caption and an event handler
      MenuItem^ menuItem1 = gcnew MenuItem( "&New",gcnew System::EventHandler(
         this, &Form1::MenuItem1_Click ) );
   }

private:
   // This method is an event handler for menuItem1 to use when connecting its event handler.
   void MenuItem1_Click( Object^ sender, System::EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }
public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}
  
Public Sub CreateMyMenuItem()
    ' Create an instance of MenuItem with caption and an event 
    ' handler
    Dim MenuItem1 As New MenuItem("&New", New _
        System.EventHandler(AddressOf Me.MenuItem1_Click))
End Sub
' This method is an event handler for MenuItem1 to use when 
' connecting its event handler.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal _
    e as System.EventArgs)
    ' Code goes here that handles the Click event.
End Sub
  

Comentarios

Cuando se especifica un título para el elemento de menú con el text parámetro, también puede especificar una clave de acceso, colocando '&' antes del carácter que se usará como la clave de acceso.When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' before the character to be used as the access key. Por ejemplo, para especificar la "F" en "File" como una clave de acceso, podría especificar el título del elemento de menú como "& archivo".For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". Puede usar esta característica para proporcionar navegación mediante el teclado para los menús.You can use this feature to provide keyboard navigation for your menus.

Establecer el text parámetro a "-" hace que el elemento de menú se muestre como un separador (una línea horizontal) en lugar de un elemento de menú estándar.Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

Además, puede utilizar este constructor para especificar un delegado que va a controlar el Click eventos para el elemento de menú que se está creando.In addition, you can use this constructor to specify a delegate that will handle the Click event for the menu item being created. El EventHandler que pasar a este constructor debe configurarse para llamar a un controlador de eventos que puede controlar la Click eventos.The EventHandler that you pass to this constructor must be configured to call an event handler that can handle the Click event. Para obtener más información sobre cómo controlar eventos, vea controlar y provocar eventos.For more information on handling events, see Handling and Raising Events.

MenuItem(String, MenuItem[]) MenuItem(String, MenuItem[]) MenuItem(String, MenuItem[]) 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.

public:
 MenuItem(System::String ^ text, cli::array <System::Windows::Forms::MenuItem ^> ^ items);
public MenuItem (string text, System.Windows.Forms.MenuItem[] items);
new System.Windows.Forms.MenuItem : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
Public Sub New (text As String, items As MenuItem())

Parámetros

text
String String String String

Título del elemento de menú.The caption for the menu item.

items
MenuItem[]

Matriz de objetos MenuItem que contiene los elementos de submenú de este elemento de menú.An array of MenuItem objects that contains the submenu items for this menu item.

Ejemplos

En el ejemplo de código siguiente se crea un objeto con el título especificado, un controlador de eventos conectado a un método que controlará el evento de cada elemento de menú en una matriz de elementos de submenú.The following code example creates an object with a specified caption, an event handler connected to a method that will handle the event each menu item in an array of submenu items.

public:
   void CreateMyMenuItem()
   {
      // submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      // Create an instance of a MenuItem with caption and an array of submenu
      // items specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&Colors",subMenus );
   }
public void CreateMyMenuItem()
{
   // submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");
   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   // Create an instance of a MenuItem with caption and an array of submenu
   // items specified.
   MenuItem MenuItem1 = new MenuItem("&Colors", subMenus);
}
  
Public Sub CreateMyMenuItem()
    ' submenu item array.
    Dim subMenus(3) As MenuItem
    ' Create three menu items to add to the submenu item array.
    Dim subMenuItem1 As New MenuItem("Red")
    Dim subMenuItem2 As New MenuItem("Blue")
    Dim subMenuItem3 As New MenuItem("Green")
    ' Add the submenu items to the array.
    subMenus(0) = subMenuItem1
    subMenus(1) = subMenuItem2
    subMenus(2) = subMenuItem3
    ' Create an instance of a MenuItem with caption and an array of submenu
    ' items specified.
    Dim MenuItem1 As New MenuItem("&Colors", subMenus)
End Sub

Comentarios

Cuando se especifica un título para el elemento de menú con el text parámetro, también puede especificar una clave de acceso, colocando '&' antes del carácter que se usará como la clave de acceso.When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' before the character to be used as the access key. Por ejemplo, para especificar la "F" en "File" como una clave de acceso, podría especificar el título del elemento de menú como "& archivo".For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". Puede usar esta característica para proporcionar navegación mediante el teclado para los menús.You can use this feature to provide keyboard navigation for your menus.

Establecer el text parámetro a "-" hace que el elemento de menú se muestre como un separador (una línea horizontal) en lugar de un elemento de menú estándar.Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

El items parámetro le permite asignar una matriz de elementos de menú para definir un submenú de este elemento de menú.The items parameter enables you to assign an array of menu items to define a submenu of this menu item. Cada elemento de la matriz puede tener también una matriz de elementos de menú asignado a ella.Each item in the array can also have an array of menu items assigned to it. Esto permite crear estructuras de menú completas y asignarlas al constructor del elemento de menú.This enables you to create complete menu structures and assign them to the constructor for the menu item.

Para obtener más información sobre cómo controlar eventos, vea controlar y provocar eventos.For more information on handling events, see Handling and Raising Events.

MenuItem(String, EventHandler, Shortcut) MenuItem(String, EventHandler, Shortcut) 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.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick, System::Windows::Forms::Shortcut shortcut);
public MenuItem (string text, EventHandler onClick, System.Windows.Forms.Shortcut shortcut);
new System.Windows.Forms.MenuItem : string * EventHandler * System.Windows.Forms.Shortcut -> System.Windows.Forms.MenuItem

Parámetros

text
String String String String

Título del elemento de menú.The caption for the menu item.

onClick
EventHandler EventHandler EventHandler EventHandler

EventHandler que trata el evento Click para este elemento de menú.The EventHandler that handles the Click event for this menu item.

shortcut
Shortcut Shortcut Shortcut Shortcut

Uno de los valores de Shortcut.One of the Shortcut values.

Ejemplos

En el ejemplo de código siguiente se crea un objeto con un título especificado, tecla de método abreviado y un controlador de eventos conectado a un método que controlará el evento para el elemento de menú.The following code example creates an object with a specified caption, shortcut key, and an event handler connected to a method that will handle the event for the menu item.

public:
   void CreateMyMenuItem()
   {
      // Create a MenuItem with caption, shortcut key, and an event handler
      // specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&New",
         gcnew System::EventHandler( this, &Form1::MenuItem1_Click ), Shortcut::CtrlL );
   }

private:
   // The following method is an event handler for menuItem1 to use when
   // connecting the event handler.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }
public void CreateMyMenuItem()
{
   // Create a MenuItem with caption, shortcut key, and an event handler
   // specified.
   MenuItem MenuItem1 = new MenuItem("&New",
       new System.EventHandler(this.MenuItem1_Click), Shortcut.CtrlL);
}

// The following method is an event handler for menuItem1 to use when
// connecting the event handler.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}
  
Public Sub CreateMyMenuItem()
    ' Create a MenuItem with caption, shortcut key, and an event handler
    ' specified.
    Dim MenuItem1 As New MenuItem("&New", _
       New System.EventHandler(AddressOf Me.MenuItem1_Click), Shortcut.CtrlL)
End Sub    
   
' The following method is an event handler for menuItem1 to use when
' connecting the event handler.
Private Sub MenuItem1_Click(sender As Object, e As EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Comentarios

Cuando se especifica un título para el elemento de menú con el text parámetro, también puede especificar una clave de acceso, colocando '&' antes del carácter que se usará como la clave de acceso.When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' before the character to be used as the access key. Por ejemplo, para especificar la "F" en "File" como una clave de acceso, podría especificar el título del elemento de menú como "& archivo".For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". Puede usar esta característica para proporcionar navegación mediante el teclado para los menús.You can use this feature to provide keyboard navigation for your menus. Este constructor también permite especificar una tecla de método abreviado además de una clave de acceso para proporcionar navegación mediante el teclado.This constructor also enables you to specify a shortcut key in addition to an access key to provide keyboard navigation. Teclas de método abreviado le permiten especificar una combinación de teclas que puede usarse para activar el elemento de menú.Shortcut keys allow you to specify a combination of keys that can be used to activate the menu item.

Establecer el text parámetro a "-" hace que el elemento de menú se muestre como un separador (una línea horizontal) en lugar de un elemento de menú estándar.Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

Además, puede utilizar este constructor para especificar un delegado que va a controlar el Click eventos para el elemento de menú que se está creando.In addition, you can use this constructor to specify a delegate that will handle the Click event for the menu item being created. El EventHandler que pasar a este constructor debe configurarse para llamar a un controlador de eventos que puede controlar la Click eventos.The EventHandler that you pass to this constructor must be configured to call an event handler that can handle the Click event. Para obtener más información sobre cómo controlar eventos, vea controlar y provocar eventos.For more information on handling events, see Handling and Raising Events.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[]) MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[]) 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.

public:
 MenuItem(System::Windows::Forms::MenuMerge mergeType, int mergeOrder, System::Windows::Forms::Shortcut shortcut, System::String ^ text, EventHandler ^ onClick, EventHandler ^ onPopup, EventHandler ^ onSelect, cli::array <System::Windows::Forms::MenuItem ^> ^ items);
public MenuItem (System.Windows.Forms.MenuMerge mergeType, int mergeOrder, System.Windows.Forms.Shortcut shortcut, string text, EventHandler onClick, EventHandler onPopup, EventHandler onSelect, System.Windows.Forms.MenuItem[] items);
new System.Windows.Forms.MenuItem : System.Windows.Forms.MenuMerge * int * System.Windows.Forms.Shortcut * string * EventHandler * EventHandler * EventHandler * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Parámetros

mergeType
MenuMerge MenuMerge MenuMerge MenuMerge

Uno de los valores de MenuMerge.One of the MenuMerge values.

mergeOrder
Int32 Int32 Int32 Int32

La posición relativa que este elemento de menú ocupará en un menú combinado.The relative position that this menu item will take in a merged menu.

shortcut
Shortcut Shortcut Shortcut Shortcut

Uno de los valores de Shortcut.One of the Shortcut values.

text
String String String String

Título del elemento de menú.The caption for the menu item.

onClick
EventHandler EventHandler EventHandler EventHandler

EventHandler que trata el evento Click para este elemento de menú.The EventHandler that handles the Click event for this menu item.

onPopup
EventHandler EventHandler EventHandler EventHandler

EventHandler que trata el evento Popup para este elemento de menú.The EventHandler that handles the Popup event for this menu item.

onSelect
EventHandler EventHandler EventHandler EventHandler

EventHandler que trata el evento Select para este elemento de menú.The EventHandler that handles the Select event for this menu item.

items
MenuItem[]

Matriz de objetos MenuItem que contiene los elementos de submenú de este elemento de menú.An array of MenuItem objects that contains the submenu items for this menu item.

Ejemplos

En el ejemplo de código siguiente se crea un elemento de menú que tiene una clave de título y el método abreviado.The following code example creates a menu item that has a caption and shortcut key. El elemento de menú también tiene controladores de eventos definidos para el Popup, Click, y Select eventos.The menu item also has event handlers defined for the Popup, Click, and Select events. Si este elemento de menú se combinan, agregará el elemento de menú al menú con el orden de combinación de cero.If this menu item is merged, it will add the menu item to the menu with the merge order of zero.

public:
   void CreateMyMenuItem()
   {
      // Submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      /* Create a MenuItem with caption, shortcut key, 
         a Click, Popup, and Select event handler, merge type and order, and an 
         array of submenu items specified.
      */
      MenuItem^ menuItem1 = gcnew MenuItem( MenuMerge::Add, 0,
         Shortcut::CtrlShiftC, "&Colors",
         gcnew EventHandler( this, &Form1::MenuItem1_Click ),
         gcnew EventHandler( this, &Form1::MenuItem1_Popup ),
         gcnew EventHandler( this, &Form1::MenuItem1_Select ), subMenus );
   }

private:
   // The following method is an event handler for menuItem1 to use when connecting the Click event.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Popup event.
   void MenuItem1_Popup( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Select event
   void MenuItem1_Select( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }
public void CreateMyMenuItem()
{
   // Submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");

   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   /* Create a MenuItem with caption, shortcut key, 
      a Click, Popup, and Select event handler, merge type and order, and an 
      array of submenu items specified.
   */
   MenuItem menuItem1 = new MenuItem(MenuMerge.Add, 0,
      Shortcut.CtrlShiftC, "&Colors", 
      new EventHandler(this.MenuItem1_Click),
      new EventHandler(this.MenuItem1_Popup),
      new EventHandler(this.MenuItem1_Select), subMenus);
}

// The following method is an event handler for menuItem1 to use when connecting the Click event.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Popup event.
private void MenuItem1_Popup(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Select event
private void MenuItem1_Select(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
   ' Submenu item array.
   Dim SubMenus(3) as MenuItem
   ' Create three menu items to add to the submenu item array.
   Dim SubMenuItem1, SubMenuItem2, SubMenuItem3 as MenuItem
   SubMenuItem1 = New MenuItem ("Red")
   SubMenuItem2 = New MenuItem ("Blue")
   SubMenuItem3 = New MenuItem ("Green")
   ' Add the submenu items to the array.
   SubMenus(0) = SubMenuItem1
   SubMenus(1) = SubMenuItem2
   SubMenus(2) = SubMenuItem3
   ' Create a MenuItem with caption, shortcut key, 
   ' a Click, Popup, and Select event handler, menu merge type and order, and an 
   ' array of submenu items specified.
   Dim MenuItem1 As MenuItem
   MenuItem1 = New MenuItem(MenuMerge.Add, 0, Shortcut.CtrlShiftC, "&Colors", _
      AddressOf Me.MenuItem1_Click, _
      AddressOf Me.MenuItem1_Popup, _
      AddressOf Me.MenuItem1_Select, SubMenus)
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Click event.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Popup event.
Private Sub MenuItem1_Popup(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Select event
Private Sub MenuItem1_Select(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

Comentarios

Cuando se especifica un título para el elemento de menú con el text parámetro, también puede especificar una clave de acceso, colocando '&' antes del carácter que se usará como la clave de acceso.When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' before the character to be used as the access key. Por ejemplo, para especificar la "F" en "File" como una clave de acceso, podría especificar el título del elemento de menú como "& archivo".For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". Puede usar esta característica para proporcionar navegación mediante el teclado para los menús.You can use this feature to provide keyboard navigation for your menus.

Establecer el text parámetro a "-" hace que el elemento de menú se muestre como un separador (una línea horizontal) en lugar de un elemento de menú estándar.Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

El items parámetro le permite asignar una matriz de elementos de menú para definir un submenú de este elemento de menú.The items parameter enables you to assign an array of menu items to define a submenu of this menu item. Cada elemento de la matriz puede tener también una matriz de elementos de menú asignado a ella.Each item in the array can also have an array of menu items assigned to it. Esto permite crear estructuras de menú completas y asignarlas al constructor del elemento de menú.This enables you to create complete menu structures and assign them to the constructor for the menu item.

El mergeType y mergeOrder parámetros le permiten determinar cómo se comportará este elemento de menú cuando el elemento de menú se combine con otro menú.The mergeType and mergeOrder parameters allow you to determine how this menu item will behave when the menu item is merged with another menu. Dependiendo del valor que especifique para el mergeType parámetro, se puede agregar, quitar, reemplazar o combinar el elemento de menú y sus elementos de submenú del menú que se está combinando con.Depending on the value you specify for the mergeType parameter, you can either add, remove, replace, or merge the menu item and its submenu items with the menu that it is merging with. El mergeOrder parámetro determina dónde se ubicará el elemento de menú que se va a crear cuando se combine el menú.The mergeOrder parameter determines where the menu item being created will be positioned when the menu is merged.

Además, puede utilizar este constructor para crear un MenuItem y conectarlo a un controlador de eventos en el código que va a procesar al hacer clic en el elemento de menú.In addition, you can use this constructor to create a MenuItem and have it connected to an event handler in your code that will process the click of the menu item. El EventHandler que se pasa a este constructor debe configurarse para llamar a un controlador de eventos que puede controlar la Click eventos.The EventHandler that you pass into this constructor should be configured to call an event handler that can handle the Click event. Mediante el uso de esta versión del constructor, también se puede conectar el Popup y Select eventos para determinar cuando se selecciona este elemento de menú.By using this constructor version, you can also connect the Popup and Select events to determine when this menu item is selected. Puede utilizar estos eventos para tareas como determinar si se va a mostrar una marca de verificación junto a los elementos de submenú o habilitar o deshabilitar elementos de menú en función del estado de la aplicación o no.You can use these events for tasks such as determining whether or not to display a check mark next to submenu items or to enable or disable menu items based on the state of the application. El Select y Click eventos solo se generan para MenuItem objetos primarios no los elementos de menú.The Select and Click events are raised only for MenuItem objects that are not parent menu items. Para obtener más información sobre cómo controlar eventos, vea controlar y provocar eventos.For more information on handling events, see Handling and Raising Events.

Consulte también:

Se aplica a