MenuItem Konstruktorer

Källa:

MenuItem.cs

Källa:

MenuItem.cs

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Exempel

I följande kodexempel skapas en MenuItem med den här versionen av konstruktorn.

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

Kommentarer

När du har skapat ett tomt objekt MenuItem med den här konstruktorn kan du använda egenskaperna och metoderna för MenuItem klassen för att ange utseendet och beteendet för din MenuItem.

Källa:

MenuItem.cs

Källa:

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)

Parametrar

Exempel

I följande kodexempel skapas en MenuItem som anger undertexten för menyalternativet när det skapas.

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

Kommentarer

När du anger en undertext för menyalternativet med parametern text kan du också ange en åtkomstnyckel genom att placera ett '&' tecken före tecknet som ska användas som åtkomstnyckel. Om du till exempel vill ange "F" i "Arkiv" som en åtkomstnyckel anger du undertexten för menyalternativet som "&File". Du kan använda den här funktionen för att tillhandahålla tangentbordsnavigering för dina menyer.

Om du anger parametern text till "-" visas menyalternativet som en avgränsare (en vågrät linje) i stället för ett standardmenyobjekt.

Källa:

MenuItem.cs

Källa:

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)

Parametrar

Exempel

I följande kodexempel skapas ett MenuItem objekt med en angiven undertext och ett EventHandler ombud som är anslutet till en händelsehanterare som hanterar Click händelsen för menyalternativet.

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

Kommentarer

När du anger en undertext för menyalternativet med parametern text kan du också ange en åtkomstnyckel genom att placera en '&' före tecknet som ska användas som åtkomstnyckel. Om du till exempel vill ange "F" i "Arkiv" som en åtkomstnyckel anger du undertexten för menyalternativet som "&File". Du kan använda den här funktionen för att tillhandahålla tangentbordsnavigering för dina menyer.

Om du anger parametern text till "-" visas menyalternativet som en avgränsare (en vågrät linje) i stället för ett standardmenyobjekt.

Dessutom kan du använda den här konstruktorn för att ange ett ombud som hanterar Click händelsen för menyalternativet som skapas. Det EventHandler som du skickar till den här konstruktorn måste konfigureras för att anropa en händelsehanterare som kan hantera Click händelsen. Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Källa:

MenuItem.cs

Källa:

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

Parametrar

Exempel

I följande kodexempel skapas ett objekt med en angiven undertext, en händelsehanterare som är ansluten till en metod som hanterar händelsen varje menyalternativ i en matris med undermenyobjekt.

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

Kommentarer

När du anger en undertext för menyalternativet med parametern text kan du också ange en åtkomstnyckel genom att placera en '&' före tecknet som ska användas som åtkomstnyckel. Om du till exempel vill ange "F" i "Arkiv" som en åtkomstnyckel anger du undertexten för menyalternativet som "&File". Du kan använda den här funktionen för att tillhandahålla tangentbordsnavigering för dina menyer.

Om du anger parametern text till "-" visas menyalternativet som en avgränsare (en vågrät linje) i stället för ett standardmenyobjekt.

Med items parametern kan du tilldela en matris med menyalternativ för att definiera en undermeny för det här menyalternativet. Varje objekt i matrisen kan också ha en matris med menyobjekt tilldelade till sig. På så sätt kan du skapa fullständiga menystrukturer och tilldela dem till konstruktorn för menyalternativet.

Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Källa:

MenuItem.cs

Källa:

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)

Parametrar

Exempel

I följande kodexempel skapas ett objekt med en angiven bildtext, kortkommando och en händelsehanterare som är ansluten till en metod som hanterar händelsen för menyalternativet.

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

Kommentarer

När du anger en undertext för menyalternativet med parametern text kan du också ange en åtkomstnyckel genom att placera en '&' före tecknet som ska användas som åtkomstnyckel. Om du till exempel vill ange "F" i "Arkiv" som en åtkomstnyckel anger du undertexten för menyalternativet som "&File". Du kan använda den här funktionen för att tillhandahålla tangentbordsnavigering för dina menyer. Med den här konstruktorn kan du också ange en genvägsnyckel utöver en åtkomstnyckel för att tillhandahålla tangentbordsnavigering. Med kortkommandon kan du ange en kombination av nycklar som kan användas för att aktivera menyalternativet.

Om du anger parametern text till "-" visas menyalternativet som en avgränsare (en vågrät linje) i stället för ett standardmenyobjekt.

Dessutom kan du använda den här konstruktorn för att ange ett ombud som hanterar Click händelsen för menyalternativet som skapas. Det EventHandler som du skickar till den här konstruktorn måste konfigureras för att anropa en händelsehanterare som kan hantera Click händelsen. Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Källa:

MenuItem.cs

Källa:

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

Parametrar

Exempel

I följande kodexempel skapas ett menyalternativ som har en bildtext och en kortkommandonyckel. Menyalternativet har också händelsehanterare som definierats för Popuphändelserna , Clickoch Select . Om det här menyalternativet sammanfogas läggs menyobjektet till i menyn med sammanslagningsordningen noll.

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

Kommentarer

När du anger en undertext för menyalternativet med parametern text kan du också ange en åtkomstnyckel genom att placera en '&' före tecknet som ska användas som åtkomstnyckel. Om du till exempel vill ange "F" i "Arkiv" som en åtkomstnyckel anger du undertexten för menyalternativet som "&File". Du kan använda den här funktionen för att tillhandahålla tangentbordsnavigering för dina menyer.

Om du anger parametern text till "-" visas menyalternativet som en avgränsare (en vågrät linje) i stället för ett standardmenyobjekt.

Med items parametern kan du tilldela en matris med menyalternativ för att definiera en undermeny för det här menyalternativet. Varje objekt i matrisen kan också ha en matris med menyobjekt tilldelade till sig. På så sätt kan du skapa fullständiga menystrukturer och tilldela dem till konstruktorn för menyalternativet.

Med mergeType parametrarna och mergeOrder kan du bestämma hur det här menyalternativet ska bete sig när menyalternativet sammanfogas med en annan meny. Beroende på vilket värde du anger för parametern mergeType kan du antingen lägga till, ta bort, ersätta eller sammanfoga menyalternativet och dess undermenyobjekt med den meny som den sammanfogas med. Parametern mergeOrder avgör var menyalternativet som skapas placeras när menyn slås samman.

Dessutom kan du använda den här konstruktorn för att skapa en MenuItem och ha den ansluten till en händelsehanterare i koden som bearbetar klicket på menyalternativet. Den EventHandler som du skickar till den här konstruktorn ska konfigureras för att anropa en händelsehanterare som kan hantera Click händelsen. Genom att använda den här konstruktorversionen kan du även ansluta Popup händelserna och Select för att avgöra när det här menyalternativet har valts. Du kan använda dessa händelser för uppgifter som att avgöra om en bockmarkering ska visas bredvid undermenyobjekt eller för att aktivera eller inaktivera menyalternativ baserat på programmets tillstånd. Händelserna Select och Click aktiveras endast för MenuItem objekt som inte är överordnade menyobjekt. Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Se även

• Popup
• Select
• Click
• MergeType
• MergeOrder