MenuItem Constructors

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Voorbeelden

In het volgende codevoorbeeld wordt een MenuItem met deze versie van de constructor gemaakt.

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

Opmerkingen

Zodra u een lege MenuItem waarde hebt gemaakt met deze constructor, kunt u de eigenschappen en methoden van de MenuItem klasse gebruiken om het uiterlijk en gedrag van uw MenuItemklasse op te geven.

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)

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een MenuItem bestand gemaakt waarmee het bijschrift van het menu-item wordt opgegeven op het moment dat deze is samengesteld.

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

Opmerkingen

Wanneer u een bijschrift opgeeft voor uw menu-item met de text parameter, kunt u ook een toegangssleutel opgeven door een '&' teken te plaatsen voordat het teken wordt gebruikt als toegangssleutel. Als u bijvoorbeeld de 'F' in 'Bestand' wilt opgeven als een toegangssleutel, geeft u het bijschrift voor het menu-item op als '&Bestand'. U kunt deze functie gebruiken om toetsenbordnavigatie te bieden voor uw menu's.

Als u de text parameter instelt op '-' wordt uw menu-item weergegeven als scheidingsteken (een horizontale lijn) in plaats van een standaardmenu-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)

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een MenuItem object gemaakt met een opgegeven bijschrift en een EventHandler gemachtigde die is verbonden met een gebeurtenis-handler waarmee de Click gebeurtenis voor het menu-item wordt verwerkt.

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

Opmerkingen

Wanneer u een bijschrift opgeeft voor uw menu-item met de text parameter, kunt u ook een toegangssleutel opgeven door een '&' te plaatsen voordat het teken wordt gebruikt als toegangssleutel. Als u bijvoorbeeld de 'F' in 'Bestand' wilt opgeven als een toegangssleutel, geeft u het bijschrift voor het menu-item op als '&Bestand'. U kunt deze functie gebruiken om toetsenbordnavigatie te bieden voor uw menu's.

Als u de text parameter instelt op '-' wordt uw menu-item weergegeven als scheidingsteken (een horizontale lijn) in plaats van een standaardmenu-item.

Daarnaast kunt u deze constructor gebruiken om een gemachtigde op te geven die de Click gebeurtenis verwerkt voor het menu-item dat wordt gemaakt. De EventHandler die u aan deze constructor doorgeeft, moet worden geconfigureerd om een gebeurtenis-handler aan te roepen die de Click gebeurtenis kan verwerken. Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

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())

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een object met een opgegeven bijschrift gemaakt, een gebeurtenis-handler die is verbonden met een methode die de gebeurtenis afhandelt voor elk menu-item in een matrix met 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

Opmerkingen

Wanneer u een bijschrift opgeeft voor uw menu-item met de text parameter, kunt u ook een toegangssleutel opgeven door een '&' te plaatsen voordat het teken wordt gebruikt als toegangssleutel. Als u bijvoorbeeld de 'F' in 'Bestand' wilt opgeven als een toegangssleutel, geeft u het bijschrift voor het menu-item op als '&Bestand'. U kunt deze functie gebruiken om toetsenbordnavigatie te bieden voor uw menu's.

Als u de text parameter instelt op '-' wordt uw menu-item weergegeven als scheidingsteken (een horizontale lijn) in plaats van een standaardmenu-item.

items Met de parameter kunt u een matrix met menu-items toewijzen om een submenu van dit menu-item te definiëren. Aan elk item in de matrix kan ook een matrix met menu-items zijn toegewezen. Hiermee kunt u volledige menustructuren maken en deze toewijzen aan de constructor voor het menu-item.

Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

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)

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een object gemaakt met een opgegeven bijschrift, sneltoets en een gebeurtenis-handler die is verbonden met een methode waarmee de gebeurtenis voor het menu-item wordt verwerkt.

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

Opmerkingen

Wanneer u een bijschrift opgeeft voor uw menu-item met de text parameter, kunt u ook een toegangssleutel opgeven door een '&' te plaatsen voordat het teken wordt gebruikt als toegangssleutel. Als u bijvoorbeeld de 'F' in 'Bestand' wilt opgeven als een toegangssleutel, geeft u het bijschrift voor het menu-item op als '&Bestand'. U kunt deze functie gebruiken om toetsenbordnavigatie te bieden voor uw menu's. Met deze constructor kunt u ook een sneltoets opgeven naast een toegangstoets om toetsenbordnavigatie te bieden. Met sneltoetsen kunt u een combinatie van toetsen opgeven die kunnen worden gebruikt om het menu-item te activeren.

Als u de text parameter instelt op '-' wordt uw menu-item weergegeven als scheidingsteken (een horizontale lijn) in plaats van een standaardmenu-item.

Daarnaast kunt u deze constructor gebruiken om een gemachtigde op te geven die de Click gebeurtenis verwerkt voor het menu-item dat wordt gemaakt. De EventHandler die u aan deze constructor doorgeeft, moet worden geconfigureerd om een gebeurtenis-handler aan te roepen die de Click gebeurtenis kan verwerken. Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

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())

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een menu-item gemaakt met een bijschrift en sneltoets. In het menu-item zijn ook gebeurtenis-handlers gedefinieerd voor de Popup, Clicken Select gebeurtenissen. Als dit menu-item is samengevoegd, wordt het menu-item toegevoegd aan het menu met de samenvoegvolgorde van nul.

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

Opmerkingen

Wanneer u een bijschrift opgeeft voor uw menu-item met de text parameter, kunt u ook een toegangssleutel opgeven door een '&' te plaatsen voordat het teken wordt gebruikt als toegangssleutel. Als u bijvoorbeeld de 'F' in 'Bestand' wilt opgeven als een toegangssleutel, geeft u het bijschrift voor het menu-item op als '&Bestand'. U kunt deze functie gebruiken om toetsenbordnavigatie te bieden voor uw menu's.

Als u de text parameter instelt op '-' wordt uw menu-item weergegeven als scheidingsteken (een horizontale lijn) in plaats van een standaardmenu-item.

items Met de parameter kunt u een matrix met menu-items toewijzen om een submenu van dit menu-item te definiëren. Aan elk item in de matrix kan ook een matrix met menu-items zijn toegewezen. Hiermee kunt u volledige menustructuren maken en deze toewijzen aan de constructor voor het menu-item.

Met de mergeType parameters mergeOrder kunt u bepalen hoe dit menu-item zich gedraagt wanneer het menu-item wordt samengevoegd met een ander menu. Afhankelijk van de waarde die u opgeeft voor de mergeType parameter, kunt u het menu-item en de bijbehorende submenu-items toevoegen, verwijderen, vervangen of samenvoegen door het menu waarmee deze wordt samengevoegd. De mergeOrder parameter bepaalt waar het menu-item dat wordt gemaakt, wordt weergegeven wanneer het menu wordt samengevoegd.

Daarnaast kunt u deze constructor gebruiken om een MenuItem gebeurtenis-handler te maken en deze te laten verbinden met een gebeurtenis-handler in uw code waarmee de klik van het menu-item wordt verwerkt. Het EventHandler exemplaar dat u in deze constructor doorgeeft, moet worden geconfigureerd om een gebeurtenis-handler aan te roepen die de Click gebeurtenis kan verwerken. Met behulp van deze constructorversie kunt u ook de Popup en Select gebeurtenissen verbinden om te bepalen wanneer dit menu-item is geselecteerd. U kunt deze gebeurtenissen gebruiken voor taken, zoals het bepalen of er een vinkje naast submenu-items moet worden weergegeven of om menu-items in of uit te schakelen op basis van de status van de toepassing. De Select gebeurtenissen worden Click alleen gegenereerd voor MenuItem objecten die geen bovenliggende menu-items zijn. Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

Zie ook

• Popup
• Select
• Click
• MergeType
• MergeOrder