MenuItem Construtores

Origem:

MenuItem.cs

Origem:

MenuItem.cs

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Exemplos

O seguinte exemplo de código cria um MenuItem usando esta 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

Observações

Depois de criar um espaço em MenuItem branco usando este construtor, pode usar as propriedades e métodos da MenuItem 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 seguinte exemplo de código cria um MenuItem que especifica a legenda do item do menu no momento em que é 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

Observações

Quando especificas uma legenda para o teu item do menu com o text parâmetro, também podes especificar uma chave de acesso colocando um carácter '&' antes do carácter a ser usado como chave de acesso. Por exemplo, para especificar o "F" em "Ficheiro" como chave de acesso, deveria especificar a legenda do item do menu como "&Ficheiro". Pode usar esta funcionalidade para fornecer navegação por teclado nos seus menus.

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

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 seguinte cria um MenuItem objeto com uma legenda especificada e um EventHandler delegado ligado a um gestor de eventos que irá tratar do Click evento para o item do 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

Observações

Quando especificas uma legenda para o teu item do menu com o text parâmetro, também podes especificar uma chave de acesso colocando um '&' antes do carácter a usar como chave de acesso. Por exemplo, para especificar o "F" em "Ficheiro" como chave de acesso, deveria especificar a legenda do item do menu como "&Ficheiro". Pode usar esta funcionalidade para fornecer navegação por teclado nos seus menus.

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

Além disso, pode usar este construtor para especificar um delegado que irá tratar do Click evento para o item do menu que está a ser criado. O EventHandler que passa para este construtor deve estar configurado para chamar um gestor de eventos que possa gerir o Click evento. Para mais informações sobre gestão de eventos, consulte Gestão e Arrecadação de 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 seguinte cria um objeto com uma legenda especificada, um gestor de eventos ligado a um método que irá tratar de cada item do menu num array de itens do 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

Observações

Quando especificas uma legenda para o teu item do menu com o text parâmetro, também podes especificar uma chave de acesso colocando um '&' antes do carácter a usar como chave de acesso. Por exemplo, para especificar o "F" em "Ficheiro" como chave de acesso, deveria especificar a legenda do item do menu como "&Ficheiro". Pode usar esta funcionalidade para fornecer navegação por teclado nos seus menus.

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

O items parâmetro permite-lhe atribuir um array de itens do menu para definir um submenu desse item do menu. Cada item do array pode também ter um array de itens de menu atribuídos. Isto permite-lhe criar estruturas completas de menu e atribuí-las ao construtor para o item do menu.

Para mais informações sobre gestão de eventos, consulte Gestão e Arrecadação de 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 seguinte cria um objeto com uma legenda especificada, uma tecla de atalho e um gestor de eventos ligados a um método que irá tratar do evento do item do 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

Observações

Quando especificas uma legenda para o teu item do menu com o text parâmetro, também podes especificar uma chave de acesso colocando um '&' antes do carácter a usar como chave de acesso. Por exemplo, para especificar o "F" em "Ficheiro" como chave de acesso, deveria especificar a legenda do item do menu como "&Ficheiro". Pode usar esta funcionalidade para fornecer navegação por teclado nos seus menus. Este construtor também permite especificar uma tecla de atalho além da tecla de acesso para fornecer navegação por teclado. As teclas de atalho permitem especificar uma combinação de teclas que pode ser usada para ativar o item do menu.

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

Além disso, pode usar este construtor para especificar um delegado que irá tratar do Click evento para o item do menu que está a ser criado. O EventHandler que passa para este construtor deve estar configurado para chamar um gestor de eventos que possa gerir o Click evento. Para mais informações sobre gestão de eventos, consulte Gestão e Arrecadação de 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 seguinte cria um item de menu que tem uma legenda e uma tecla de atalho. O item do menu também tem handlers de eventos definidos para , PopupClick, e Select eventos. Se este item do menu for fundido, será adicionado o item do menu ao menu com a ordem de fusão 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

Observações

Quando especificas uma legenda para o teu item do menu com o text parâmetro, também podes especificar uma chave de acesso colocando um '&' antes do carácter a usar como chave de acesso. Por exemplo, para especificar o "F" em "Ficheiro" como chave de acesso, deveria especificar a legenda do item do menu como "&Ficheiro". Pode usar esta funcionalidade para fornecer navegação por teclado nos seus menus.

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

O items parâmetro permite-lhe atribuir um array de itens do menu para definir um submenu desse item do menu. Cada item do array pode também ter um array de itens de menu atribuídos. Isto permite-lhe criar estruturas completas de menu e atribuí-las ao construtor para o item do menu.

Os mergeType parâmetros e mergeOrder permitem-lhe determinar como este item do menu se comportará quando o item for fundido com outro menu adicional. Dependendo do valor que especificar para o mergeType parâmetro, pode adicionar, remover, substituir ou fundir o item do menu e os seus itens do submenu com o menu com que está a ser fundido. O mergeOrder parâmetro determina onde o item do menu a ser criado estará posicionado quando o menu for fundido.

Além disso, pode usar este construtor para criar um MenuItem e tê-lo ligado a um gestor de eventos no seu código que processará o clique do item do menu. O EventHandler que passa para este construtor deve estar configurado para chamar um gestor de eventos que possa gerir o Click evento. Ao usar esta versão do construtor, também pode ligar os Popup eventos e Select para determinar quando este item do menu é selecionado. Pode usar estes eventos para tarefas como determinar se deve ou não mostrar uma marca de verificação ao lado dos itens do submenu ou ativar ou desativar elementos do menu com base no estado da aplicação. Os Select eventos and Click são levantados apenas para MenuItem objetos que não são itens do menu principal. Para mais informações sobre gestão de eventos, consulte Gestão e Arrecadação de Eventos.

Ver também

• Popup
• Select
• Click
• MergeType
• MergeOrder