Menu.MenuItemCollection.Add Metod

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till en ny MenuItem i samlingen.

Överlagringar

Name	Description
Add(String)	Lägger till en ny MenuItem, i slutet av den aktuella menyn med en angiven bildtext.
Add(MenuItem)	Lägger till en tidigare skapad MenuItem i slutet av den aktuella menyn.
Add(Int32, MenuItem)	Lägger till en tidigare skapad MenuItem i det angivna indexet i menyobjektsamlingen.
Add(String, EventHandler)	Lägger till en ny MenuItem i slutet av den aktuella menyn med en angiven bildtext och en angiven händelsehanterare för Click händelsen.
Add(String, MenuItem[])	Lägger till en ny MenuItem i slutet av den här menyn med den angivna bildtexten, Click händelsehanteraren och objekten.

Källa:: Menu.MenuItemCollection.cs

Källa:: Menu.MenuItemCollection.cs

Lägger till en ny MenuItem, i slutet av den aktuella menyn med en angiven bildtext.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption);

public virtual System.Windows.Forms.MenuItem Add(string caption);

abstract member Add : string -> System.Windows.Forms.MenuItem
override this.Add : string -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String) As MenuItem

Parametrar

caption: String

Menyalternativets bildtext.

Returer

MenuItem

En MenuItem som representerar menyalternativet som läggs till i samlingen.

Exempel

I följande kodexempel används den härledda klassen MainMenu för att skapa en huvudmeny, , mainMenu1som har två MenuItem objekt som har lagts till i samlingen MenuItems . Koden tilldelar mainMenu1Menu sedan egenskapen Formför . Det här exemplet kräver att koden som definieras i det här exemplet finns i ett formulär.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit" );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit");

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit")
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Kommentarer

En MenuItem kan bara finnas i en meny i taget och kan inte läggas till mer än en gång på samma meny. Om du vill återanvända en MenuItem i mer än en meny använder du CloneMenu -metoden för MenuItem klassen. Om du vill ta bort en MenuItem som du tidigare har lagt till använder du Remove metoden.

Se även

Remove(MenuItem)

Gäller för

Källa:: Menu.MenuItemCollection.cs

Källa:: Menu.MenuItemCollection.cs

Lägger till en tidigare skapad MenuItem i slutet av den aktuella menyn.

public:
 virtual int Add(System::Windows::Forms::MenuItem ^ item);

public virtual int Add(System.Windows.Forms.MenuItem item);

abstract member Add : System.Windows.Forms.MenuItem -> int
override this.Add : System.Windows.Forms.MenuItem -> int

Public Overridable Function Add (item As MenuItem) As Integer

Parametrar

item: MenuItem

Att MenuItem lägga till.

Returer

Int32

Det nollbaserade index där objektet lagras i samlingen.

Exempel

I följande kodexempel skapas en instans av den härledda klassen, MainMenu, och en MenuItem läggs till i dess samling av MenuItem objekt. Det här exemplet kräver att metoden som definieras i det här exemplet finns i klassen för ett formulär och anropas av en metod i den formulärklassen.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to the MainMenu menu item collection. */
      mainMenu1->MenuItems->Add( menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to the MainMenu menu item collection. */
   mainMenu1.MenuItems.Add (menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to the MainMenu menu item collection. 
    mainMenu1.MenuItems.Add(menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Kommentarer

Med den Add här versionen av metoden kan du lägga till tidigare skapade MenuItem objekt i slutet av menyobjektsamlingen.

Se även

Remove(MenuItem)

Gäller för

Källa:: Menu.MenuItemCollection.cs

Källa:: Menu.MenuItemCollection.cs

Lägger till en tidigare skapad MenuItem i det angivna indexet i menyobjektsamlingen.

public:
 virtual int Add(int index, System::Windows::Forms::MenuItem ^ item);

public virtual int Add(int index, System.Windows.Forms.MenuItem item);

abstract member Add : int * System.Windows.Forms.MenuItem -> int
override this.Add : int * System.Windows.Forms.MenuItem -> int

Public Overridable Function Add (index As Integer, item As MenuItem) As Integer

Parametrar

index: Int32

Positionen för att lägga till det nya objektet.

item: MenuItem

Att MenuItem lägga till.

Returer

Int32

Det nollbaserade index där objektet lagras i samlingen.

Undantag

Exception

Den MenuItem som läggs till används redan.

ArgumentException

Indexet som anges i parametern index är större än samlingens storlek.

Exempel

I följande kodexempel skapas en instans av den härledda klassen, MainMenu, och ett MenuItem objekt läggs till i samlingen med MenuItem objekt på en specifik plats i menyobjektsamlingen. Det här exemplet kräver att metoden som definieras i det här exemplet finns i klassen för ett formulär och anropas av en metod i den formulärklassen.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to mainMenu1 at specific index. */
      mainMenu1->MenuItems->Add( 0, menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to mainMenu1 at specific index. */
   mainMenu1.MenuItems.Add (0, menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to mainMenu1 at specific index. 
    mainMenu1.MenuItems.Add(0, menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Kommentarer

Med den Add här versionen av metoden kan du lägga till tidigare skapade MenuItem objekt till en specifik indexplats i samlingen. Alla MenuItem som för närvarande finns i indexet och alla MenuItem objekt efter det indexet flyttas till det näst lägsta indexet i samlingen.

Se även

Remove(MenuItem)

Gäller för

Källa:: Menu.MenuItemCollection.cs

Källa:: Menu.MenuItemCollection.cs

Lägger till en ny MenuItem i slutet av den aktuella menyn med en angiven bildtext och en angiven händelsehanterare för Click händelsen.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, EventHandler ^ onClick);

public virtual System.Windows.Forms.MenuItem Add(string caption, EventHandler onClick);

abstract member Add : string * EventHandler -> System.Windows.Forms.MenuItem
override this.Add : string * EventHandler -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String, onClick As EventHandler) As MenuItem

Parametrar

caption: String

Menyalternativets bildtext.

onClick: EventHandler

En EventHandler som representerar händelsehanteraren som anropas när objektet klickas av användaren, eller när en användare trycker på en accelerator eller genvägsnyckel för menyalternativet.

Returer

MenuItem

En MenuItem som representerar menyalternativet som läggs till i samlingen.

Exempel

I följande kodexempel används den härledda klassen MainMenu för att skapa en huvudmeny, , mainMenu1som har två MenuItem objekt som har lagts till i samlingen MenuItems . Koden använder den Add här versionen av metoden för att definiera en händelsehanterare för händelsen för Click det andra menyalternativet som lagts till i samlingen. Koden tilldelar mainMenu1Menu sedan egenskapen Formför . Det här exemplet kräver att koden som definieras i det här exemplet finns i ett formulär.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit", gcnew EventHandler(
         this, &Form1::menuItem2_Click ) );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private:
   void menuItem2_Click( System::Object^ sender, System::EventArgs^ e )
   {
      // Insert code to handle Click event.
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit", new EventHandler (menuItem2_Click));

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

private void menuItem2_Click(System.Object sender, System.EventArgs e)
{
   // Insert code to handle Click event.
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit", _
       New EventHandler(AddressOf menuItem2_Click))
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub    
   
Private Sub menuItem2_Click(sender As System.Object, e As System.EventArgs)
    ' Insert code to handle Click event.
End Sub

Kommentarer

Med den Add här versionen av metoden kan du ange en undertext för menyalternativet och ett ombud för att hantera Click händelsen. Du kan använda den Add här versionen av metoden om programmet redan har en händelsehanterare för att hantera Click händelsen.

Note

Händelsen Click aktiveras inte för en MenuItem som innehåller undermenyobjekt.

Se även

Remove(MenuItem)

Gäller för

Källa:: Menu.MenuItemCollection.cs

Källa:: Menu.MenuItemCollection.cs

Lägger till en ny MenuItem i slutet av den här menyn med den angivna bildtexten, Click händelsehanteraren och objekten.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public virtual System.Windows.Forms.MenuItem Add(string caption, System.Windows.Forms.MenuItem[] items);

abstract member Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
override this.Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String, items As MenuItem()) As MenuItem

Parametrar

caption: String

Menyalternativets bildtext.

items: MenuItem[]

En matris med MenuItem objekt som detta MenuItem ska innehålla.

Returer

MenuItem

En MenuItem som representerar menyalternativet som läggs till i samlingen.

Kommentarer

Med den Add här versionen av metoden kan du ange en undertext för menyalternativet och ett ombud som ska hantera händelsen Click . Du kan använda den Add här versionen av metoden om programmet redan har en händelsehanterare för att hantera Click händelsen. Med den här versionen av metoden kan du också ange en matris med tidigare skapade MenuItem objekt som du vill lägga till i samlingen. Du kan använda den här funktionen för att återanvända befintliga MenuItem objekt som har klonats med hjälp av CloneMenu metoden . Om parametern items inte är tom eller nullinnehåller den MenuItem som läggs till i samlingen undermenyobjekt.

Note

Händelsen Click aktiveras inte för en MenuItem som innehåller undermenyobjekt.

Se även

Remove(MenuItem)

Gäller för

Feedback

Var den här sidan till hjälp?

Menu.MenuItemCollection.Add Metod

Definition

Överlagringar

Add(String)

Parametrar

Returer

Exempel

Kommentarer

Se även

Gäller för

Add(MenuItem)

Parametrar

Returer

Exempel

Kommentarer

Se även

Gäller för

Add(Int32, MenuItem)

Parametrar

Returer

Undantag

Exempel

Kommentarer

Se även

Gäller för

Add(String, EventHandler)

Parametrar

Returer

Exempel

Kommentarer

Se även

Gäller för

Add(String, MenuItem[])

Parametrar

Returer

Kommentarer

Se även

Gäller för

Feedback