MenuItem Constructores

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Inicializa una nueva instancia de la clase MenuItem.

Sobrecargas

MenuItem()	Inicializa una clase MenuItem con un título en blanco.
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, 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ú.
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(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()

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

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.

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 que haya creado un espacio en blanco MenuItem con este constructor, puede usar las propiedades y los métodos de la MenuItem clase para especificar la apariencia y el comportamiento de MenuItem.

MenuItem(String)

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

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

Título del elemento de menú.

Ejemplos

En el ejemplo de código siguiente se crea un MenuItem objeto que especifica el subtítulo del elemento de menú en el momento en que se construye.

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

Al especificar un subtítulo para el elemento de menú con el text parámetro , también puede especificar una tecla de acceso colocando un carácter de "&" antes del carácter que se usará como tecla de acceso. Por ejemplo, para especificar "F" en "Archivo" como clave de acceso, especificaría el subtítulo para el elemento de menú como "&Archivo". Puede usar esta característica para proporcionar navegación por teclado para los menús.

Establecer el text parámetro en "-" hace que el elemento de menú se muestre como separador (una línea horizontal) en lugar de un elemento de menú estándar.

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ú.

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

Título del elemento de menú.

onClick

EventHandler

EventHandler que trata el evento Click para este elemento de menú.

Ejemplos

En el ejemplo de código siguiente se crea un MenuItem objeto con un subtítulo especificado y un EventHandler delegado conectado a un controlador de eventos que controlará el Click evento para el elemento de menú.

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

Al especificar un subtítulo para el elemento de menú con el text parámetro , también puede especificar una clave de acceso colocando una "&" antes del carácter que se usará como clave de acceso. Por ejemplo, para especificar "F" en "Archivo" como clave de acceso, especificaría el subtítulo para el elemento de menú como "&Archivo". Puede usar esta característica para proporcionar navegación por teclado para los menús.

Establecer el text parámetro en "-" hace que el elemento de menú se muestre como separador (una línea horizontal) en lugar de un elemento de menú estándar.

Además, puede usar este constructor para especificar un delegado que controlará el Click evento para el elemento de menú que se va a crear. El EventHandler objeto que se pasa a este constructor debe configurarse para llamar a un controlador de eventos que pueda controlar el Click evento. Para obtener más información sobre el control de eventos, consulte Control y generación de eventos.

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ú.

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

Título del elemento de menú.

items

MenuItem[]

Matriz de objetos MenuItem que contiene los elementos de submenú de este elemento de menú.

Ejemplos

En el ejemplo de código siguiente se crea un objeto con un subtítulo especificado, un controlador de eventos conectado a un método que controlará el evento cada elemento de menú de una matriz de elementos de submenú.

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

Al especificar un subtítulo para el elemento de menú con el text parámetro , también puede especificar una clave de acceso colocando una "&" antes del carácter que se usará como clave de acceso. Por ejemplo, para especificar "F" en "Archivo" como clave de acceso, especificaría el subtítulo para el elemento de menú como "&Archivo". Puede usar esta característica para proporcionar navegación por teclado para los menús.

Establecer el text parámetro en "-" hace que el elemento de menú se muestre como separador (una línea horizontal) en lugar de un elemento de menú estándar.

El items parámetro permite asignar una matriz de elementos de menú para definir un submenú de este elemento de menú. Cada elemento de la matriz también puede tener una matriz de elementos de menú asignados. Esto le permite crear estructuras de menú completas y asignarlas al constructor del elemento de menú.

Para obtener más información sobre el control de eventos, consulte Control y generación de eventos.

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ú.

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

Public Sub New (text As String, onClick As EventHandler, shortcut As Shortcut)

Parámetros

text

String

Título del elemento de menú.

onClick

EventHandler

EventHandler que trata el evento Click para este elemento de menú.

shortcut

Shortcut

Uno de los valores de Shortcut.

Ejemplos

En el ejemplo de código siguiente se crea un objeto con un subtítulo especificado, una tecla de método abreviado y un controlador de eventos conectado a un método que controlará el evento para el elemento de menú.

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

Al especificar un subtítulo para el elemento de menú con el text parámetro , también puede especificar una clave de acceso colocando una "&" antes del carácter que se usará como clave de acceso. Por ejemplo, para especificar "F" en "Archivo" como clave de acceso, especificaría el subtítulo para el elemento de menú como "&Archivo". Puede usar esta característica para proporcionar navegación por teclado para los menús. Este constructor también permite especificar una tecla de método abreviado además de una tecla de acceso para proporcionar navegación por el teclado. Las teclas de método abreviado permiten especificar una combinación de teclas que se pueden usar para activar el elemento de menú.

Establecer el text parámetro en "-" hace que el elemento de menú se muestre como separador (una línea horizontal) en lugar de un elemento de menú estándar.

Además, puede usar este constructor para especificar un delegado que controlará el Click evento para el elemento de menú que se va a crear. El EventHandler objeto que se pasa a este constructor debe configurarse para llamar a un controlador de eventos que pueda controlar el Click evento. Para obtener más información sobre el control de eventos, consulte Control y generación de eventos.

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ú.

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

Public Sub New (mergeType As MenuMerge, mergeOrder As Integer, shortcut As Shortcut, text As String, onClick As EventHandler, onPopup As EventHandler, onSelect As EventHandler, items As MenuItem())

Parámetros

mergeType

MenuMerge

Uno de los valores de MenuMerge.

mergeOrder

Int32

La posición relativa que este elemento de menú ocupará en un menú combinado.

shortcut

Shortcut

Uno de los valores de Shortcut.

text

String

Título del elemento de menú.

onClick

EventHandler

EventHandler que trata el evento Click para este elemento de menú.

onPopup

EventHandler

EventHandler que trata el evento Popup para este elemento de menú.

onSelect

EventHandler

EventHandler que trata el evento Select para este elemento de menú.

items

MenuItem[]

Matriz de objetos MenuItem que contiene los elementos de submenú de este elemento de menú.

Ejemplos

En el ejemplo de código siguiente se crea un elemento de menú que tiene un subtítulo y una tecla de método abreviado. El elemento de menú también tiene controladores de eventos definidos para los Popupeventos , Clicky Select . Si este elemento de menú se combina, agregará el elemento de menú al menú con el orden de combinación de cero.

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

Al especificar un subtítulo para el elemento de menú con el text parámetro , también puede especificar una clave de acceso colocando una "&" antes del carácter que se usará como clave de acceso. Por ejemplo, para especificar "F" en "Archivo" como clave de acceso, especificaría el subtítulo para el elemento de menú como "&Archivo". Puede usar esta característica para proporcionar navegación por teclado para los menús.

Establecer el text parámetro en "-" hace que el elemento de menú se muestre como separador (una línea horizontal) en lugar de un elemento de menú estándar.

El items parámetro permite asignar una matriz de elementos de menú para definir un submenú de este elemento de menú. Cada elemento de la matriz también puede tener una matriz de elementos de menú asignados. Esto le permite crear estructuras de menú completas y asignarlas al constructor del elemento de menú.

Los mergeType parámetros y mergeOrder permiten determinar cómo se comportará este elemento de menú cuando el elemento de menú se combina con otro menú. Según el valor que especifique para el mergeType parámetro, puede agregar, quitar, reemplazar o combinar el elemento de menú y sus elementos de submenú con el menú con el que se combina. El mergeOrder parámetro determina dónde se colocará el elemento de menú que se va a crear cuando se combine el menú.

Además, puede usar este constructor para crear y MenuItem hacer que esté conectado a un controlador de eventos en el código que procesará el clic del elemento de menú. El EventHandler que pase a este constructor debe configurarse para llamar a un controlador de eventos que pueda controlar el Click evento. Con esta versión del constructor, también puede conectar los Popup eventos y Select para determinar cuándo se selecciona este elemento de menú. Puede usar estos eventos para tareas como determinar si se debe mostrar o no una marca de verificación junto a elementos de submenú o para habilitar o deshabilitar elementos de menú en función del estado de la aplicación. Los Select eventos y Click solo se generan para MenuItem objetos que no son elementos de menú primarios. Para obtener más información sobre el control de eventos, consulte Control y generación de eventos.

Consulte también

• Popup
• Select
• Click
• MergeType
• MergeOrder