MenuItem Construtores

Origem:

MenuItem.cs

Origem:

MenuItem.cs

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Exemplos

O exemplo de código a seguir cria um MenuItem uso desta versão do construtor.

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

Comentários

Depois de criar um espaço em branco MenuItem usando esse construtor, você pode usar as propriedades e os MenuItem métodos da classe para especificar a aparência e o comportamento do seu MenuItem.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O exemplo de código a seguir cria um MenuItem que especifica a legenda do item de menu no momento em que ele é construído.

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

Comentários

Ao especificar uma legenda para o item de menu com o text parâmetro, você também pode especificar uma chave de acesso colocando um caractere '&' antes do caractere a ser usado como a chave de acesso. Por exemplo, para especificar o "F" em "Arquivo" como uma chave de acesso, você especificaria a legenda do item de menu como "&arquivo". Você pode usar esse recurso para fornecer navegação por teclado para seus menus.

Definir o text parâmetro como "-" faz com que seu item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O exemplo de código a seguir cria um MenuItem objeto com uma legenda especificada e um EventHandler delegado conectado a um manipulador de eventos que manipulará o Click evento para o item de menu.

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

Comentários

Ao especificar uma legenda para o item de menu com o text parâmetro, você também pode especificar uma chave de acesso colocando um '&' antes do caractere a ser usado como a chave de acesso. Por exemplo, para especificar o "F" em "Arquivo" como uma chave de acesso, você especificaria a legenda do item de menu como "&arquivo". Você pode usar esse recurso para fornecer navegação por teclado para seus menus.

Definir o text parâmetro como "-" faz com que seu item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

Além disso, você pode usar esse construtor para especificar um delegado que manipulará o Click evento para o item de menu que está sendo criado. O EventHandler que você passa para esse construtor deve ser configurado para chamar um manipulador de eventos que possa manipular o Click evento. Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O exemplo de código a seguir cria um objeto com uma legenda especificada, um manipulador de eventos conectado a um método que manipulará o evento de cada item de menu em uma matriz de itens de submenu.

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

Comentários

Ao especificar uma legenda para o item de menu com o text parâmetro, você também pode especificar uma chave de acesso colocando um '&' antes do caractere a ser usado como a chave de acesso. Por exemplo, para especificar o "F" em "Arquivo" como uma chave de acesso, você especificaria a legenda do item de menu como "&arquivo". Você pode usar esse recurso para fornecer navegação por teclado para seus menus.

Definir o text parâmetro como "-" faz com que seu item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

O items parâmetro permite que você atribua uma matriz de itens de menu para definir um submenu deste item de menu. Cada item na matriz também pode ter uma matriz de itens de menu atribuídos a ele. Isso permite criar estruturas de menu completas e atribuí-las ao construtor para o item de menu.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O exemplo de código a seguir cria um objeto com uma legenda especificada, uma chave de atalho e um manipulador de eventos conectado a um método que manipulará o evento para o item de menu.

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

Comentários

Ao especificar uma legenda para o item de menu com o text parâmetro, você também pode especificar uma chave de acesso colocando um '&' antes do caractere a ser usado como a chave de acesso. Por exemplo, para especificar o "F" em "Arquivo" como uma chave de acesso, você especificaria a legenda do item de menu como "&arquivo". Você pode usar esse recurso para fornecer navegação por teclado para seus menus. Esse construtor também permite que você especifique uma tecla de atalho além de uma tecla de acesso para fornecer navegação por teclado. As teclas de atalho permitem especificar uma combinação de chaves que podem ser usadas para ativar o item de menu.

Definir o text parâmetro como "-" faz com que seu item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

Além disso, você pode usar esse construtor para especificar um delegado que manipulará o Click evento para o item de menu que está sendo criado. O EventHandler que você passa para esse construtor deve ser configurado para chamar um manipulador de eventos que possa manipular o Click evento. Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O exemplo de código a seguir cria um item de menu que tem uma legenda e uma chave de atalho. O item de menu também tem manipuladores de eventos definidos para o Popup, Clicke Select eventos. Se esse item de menu for mesclado, ele adicionará o item de menu ao menu com a ordem de mesclagem de 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

Comentários

Ao especificar uma legenda para o item de menu com o text parâmetro, você também pode especificar uma chave de acesso colocando um '&' antes do caractere a ser usado como a chave de acesso. Por exemplo, para especificar o "F" em "Arquivo" como uma chave de acesso, você especificaria a legenda do item de menu como "&arquivo". Você pode usar esse recurso para fornecer navegação por teclado para seus menus.

Definir o text parâmetro como "-" faz com que seu item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

O items parâmetro permite que você atribua uma matriz de itens de menu para definir um submenu deste item de menu. Cada item na matriz também pode ter uma matriz de itens de menu atribuídos a ele. Isso permite criar estruturas de menu completas e atribuí-las ao construtor para o item de menu.

Os mergeType parâmetros e os mergeOrder parâmetros permitem determinar como esse item de menu se comportará quando o item de menu for mesclado com outro menu. Dependendo do valor especificado para o mergeType parâmetro, você pode adicionar, remover, substituir ou mesclar o item de menu e seus itens de submenu com o menu com o qual ele está se mesclando. O mergeOrder parâmetro determina onde o item de menu que está sendo criado será posicionado quando o menu for mesclado.

Além disso, você pode usar esse construtor para criar um MenuItem e conectá-lo a um manipulador de eventos em seu código que processará o clique do item de menu. O EventHandler que você passa para esse construtor deve ser configurado para chamar um manipulador de eventos que possa manipular o Click evento. Usando essa versão do construtor, você também pode conectar e PopupSelect eventos para determinar quando esse item de menu é selecionado. Você pode usar esses eventos para tarefas como determinar se deve ou não exibir uma marca de seleção ao lado de itens de submenu ou habilitar ou desabilitar itens de menu com base no estado do aplicativo. Os Select eventos e os eventos Click são gerados apenas para MenuItem objetos que não são itens de menu pai. Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Confira também

• Popup
• Select
• Click
• MergeType
• MergeOrder