Partilhar via


MenuItem Construtores

Definição

Inicializa uma nova instância da classe MenuItem.

Sobrecargas

MenuItem()

Inicializa um MenuItem com uma legenda em branco.

MenuItem(String)

Inicializa uma nova instância da classe MenuItem com uma legenda especificada para o item de menu.

MenuItem(String, EventHandler)

Inicializa uma nova instância da classe com uma legenda e um manipulador de eventos especificados para o evento Click do item de menu.

MenuItem(String, MenuItem[])

Inicializa uma nova instância da classe com uma legenda especificada e uma matriz de itens de submenu definida para o item de menu.

MenuItem(String, EventHandler, Shortcut)

Inicializa uma nova instância da classe com uma legenda, um manipulador de eventos e a tecla de atalho associada especificados para o item de menu.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inicializa uma nova instância da classe MenuItem com uma legenda especificada; manipuladores de eventos definidos para os eventos Click, Select e Popup; uma tecla de atalho; um tipo de mesclagem e, por fim, a ordem especificada para o item de menu.

MenuItem()

Inicializa um MenuItem com uma legenda em branco.

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

Exemplos

O exemplo de código a seguir 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

Comentários

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

Aplica-se a

MenuItem(String)

Inicializa uma nova instância da classe MenuItem com uma legenda especificada para o item de menu.

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

A legenda do item de menu.

Exemplos

O exemplo de código a seguir cria um MenuItem que especifica o 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 um 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 o legenda para o 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 o item de menu seja exibido como um separador (uma linha horizontal) em vez de um item de menu padrão.

Aplica-se a

MenuItem(String, EventHandler)

Inicializa uma nova instância da classe com uma legenda e um manipulador de eventos especificados para o evento Click do item de menu.

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

A legenda do item de menu.

onClick
EventHandler

O EventHandler que manipula o evento Click deste item de menu.

Exemplos

O exemplo de código a seguir cria um MenuItem objeto com um legenda especificado 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 um 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 o legenda para o 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 o 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 gerando eventos.

Aplica-se a

MenuItem(String, MenuItem[])

Inicializa uma nova instância da classe com uma legenda especificada e uma matriz de itens de submenu definida para o item de menu.

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

A legenda do item de menu.

items
MenuItem[]

Uma matriz de objetos MenuItem que contém os itens de submenu desse item de menu.

Exemplos

O exemplo de código a seguir cria um objeto com um legenda especificado, 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 um 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 o legenda para o 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 o 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 desse item de menu. Cada item na matriz também pode ter uma matriz de itens de menu atribuídos a ele. Isso permite que você crie estruturas de menu completas e atribua-as ao construtor do item de menu.

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

Aplica-se a

MenuItem(String, EventHandler, Shortcut)

Inicializa uma nova instância da classe com uma legenda, um manipulador de eventos e a tecla de atalho associada especificados para o item de menu.

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

A legenda do item de menu.

onClick
EventHandler

O EventHandler que manipula o evento Click deste item de menu.

shortcut
Shortcut

Um dos valores de Shortcut.

Exemplos

O exemplo de código a seguir cria um objeto com um legenda, uma tecla 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 um 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 o legenda para o 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 teclas que podem ser usadas para ativar o item de menu.

Definir o text parâmetro como "-" faz com que o 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 gerando eventos.

Aplica-se a

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inicializa uma nova instância da classe MenuItem com uma legenda especificada; manipuladores de eventos definidos para os eventos Click, Select e Popup; uma tecla de atalho; um tipo de mesclagem e, por fim, a ordem especificada para o item de menu.

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

Um dos valores de MenuMerge.

mergeOrder
Int32

A posição relativa que esse item de menu ocupará em um menu mesclado.

shortcut
Shortcut

Um dos valores de Shortcut.

text
String

A legenda do item de menu.

onClick
EventHandler

O EventHandler que manipula o evento Click deste item de menu.

onPopup
EventHandler

O EventHandler que manipula o evento Popup deste item de menu.

onSelect
EventHandler

O EventHandler que manipula o evento Select deste item de menu.

items
MenuItem[]

Uma matriz de objetos MenuItem que contém os itens de submenu desse item de menu.

Exemplos

O exemplo de código a seguir cria um item de menu que tem um legenda e uma tecla de atalho. O item de menu também tem manipuladores de eventos definidos para os Popupeventos , Clicke Select . 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 um 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 o legenda para o 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 o 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 desse item de menu. Cada item na matriz também pode ter uma matriz de itens de menu atribuídos a ele. Isso permite que você crie estruturas de menu completas e atribua-as ao construtor do item de menu.

Os mergeType parâmetros e mergeOrder 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 os Popup eventos e Select para determinar quando esse item de menu está selecionado. Você pode usar esses eventos para tarefas como determinar se deve ou não exibir uma marca de marcar ao lado de itens de submenu ou para habilitar ou desabilitar itens de menu com base no estado do aplicativo. Os Select eventos e 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 gerando eventos.

Confira também

Aplica-se a