Menu.MenuItemCollection.Add Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Přidá do kolekce nový MenuItem .

Přetížení

Add(String)

Přidá novou MenuItem, na konec aktuální nabídky se zadaným popis.
Add(MenuItem)

Přidá dříve vytvořený MenuItem objekt na konec aktuální nabídky.
Add(Int32, MenuItem)

Přidá dříve vytvořený MenuItem v zadaném indexu v kolekci položek nabídky.
Add(String, EventHandler)

Přidá nový MenuItem na konec aktuální nabídky se zadaným popis a zadanou obslužnou rutinou Click události pro událost.
Add(String, MenuItem[])

Přidá na konec této nabídky nový MenuItem se zadanými popis, Click obslužnou rutinou události a položkami.

Add(String)

Přidá novou MenuItem, na konec aktuální nabídky se zadaným popis.

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

Parametry

caption
String

Popis položky nabídky.

Návraty

MenuItem

A MenuItem představující položku nabídky, která se přidává do kolekce.

Příklady

Následující příklad kódu používá odvozenou třídu MainMenu k vytvoření hlavní nabídky , mainMenu1která má dva MenuItem objekty přidané do své MenuItems kolekce. Kód pak přiřadí mainMenu1Menu vlastnost objektu Form. Tento příklad vyžaduje, aby kód definovaný v tomto příkladu byl umístěn ve formuláři .

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

Poznámky

A MenuItem může být současně obsažen pouze v jedné nabídce a nelze jej přidat více než jednou do stejné nabídky. Chcete-li znovu použít MenuItem ve více než jedné nabídce, použijte CloneMenu metodu MenuItem třídy . Pokud chcete odebrat MenuItem objekt, který jste přidali dříve, použijte metodu Remove .

Viz také

Platí pro

Add(MenuItem)

Přidá dříve vytvořený MenuItem objekt na konec aktuální nabídky.

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

Parametry

item
MenuItem

Přidá MenuItem se.

Návraty

Int32

Index založený na nule, ve kterém je položka uložena v kolekci.

Příklady

Následující příklad kódu vytvoří instanci odvozené třídy MainMenua přidá MenuItem do své kolekce MenuItem objektů . Tento příklad vyžaduje, aby metoda definovaná v tomto příkladu byla umístěna ve třídě formuláře a volána metodou v této třídě formuláře.

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

Poznámky

A MenuItem může být současně obsažen pouze v jedné nabídce a nelze jej přidat více než jednou do stejné nabídky. Chcete-li znovu použít MenuItem ve více než jedné nabídce, použijte CloneMenu metodu MenuItem třídy . Pokud chcete odebrat MenuItem objekt, který jste přidali dříve, použijte metodu Remove .

Tato verze Add metody umožňuje přidat dříve vytvořené MenuItem objekty na konec kolekce položek nabídky.

Viz také

Platí pro

Add(Int32, MenuItem)

Přidá dříve vytvořený MenuItem v zadaném indexu v kolekci položek nabídky.

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

Parametry

index
Int32

Pozice pro přidání nové položky

item
MenuItem

Přidá MenuItem se.

Návraty

Int32

Index založený na nule, ve kterém je položka uložena v kolekci.

Výjimky

Exception

Přidaná MenuItem položka se už používá.

ArgumentException

Index zadaný v parametru index je větší než velikost kolekce.

Příklady

Následující příklad kódu vytvoří instanci odvozené třídy MainMenua přidá MenuItem objekt do své kolekce MenuItem objektů v určitém umístění v kolekci položek nabídky. Tento příklad vyžaduje, aby metoda definovaná v tomto příkladu byla umístěna ve třídě formuláře a volána metodou v této třídě formuláře.

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

Poznámky

A MenuItem může být současně obsažen pouze v jedné nabídce a nelze jej přidat více než jednou do stejné nabídky. Chcete-li znovu použít MenuItem ve více než jedné nabídce, použijte CloneMenu metodu MenuItem třídy . Pokud chcete odebrat MenuItem objekt, který jste přidali dříve, použijte metodu Remove .

Tato verze Add metody umožňuje přidat dříve vytvořené MenuItem objekty do konkrétního umístění indexu v rámci kolekce. Všechny MenuItem aktuálně umístěné na daném indexu a všechny MenuItem objekty za tímto indexem se přesunou do dalšího nejnižšího indexu v kolekci.

Viz také

Platí pro

Add(String, EventHandler)

Přidá nový MenuItem na konec aktuální nabídky se zadaným popis a zadanou obslužnou rutinou Click události pro událost.

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

Parametry

caption
String

Popis položky nabídky.

onClick
EventHandler

Představuje EventHandler obslužnou rutinu události, která je volána, když uživatel klikne na položku nebo když uživatel stiskne akcelerátor nebo klávesovou zkratku pro položku nabídky.

Návraty

MenuItem

A MenuItem představující položku nabídky, která se přidává do kolekce.

Příklady

Následující příklad kódu používá odvozenou třídu MainMenu k vytvoření hlavní nabídky , mainMenu1která má dva MenuItem objekty přidané do své MenuItems kolekce. Kód používá tuto verzi Add metody k definování obslužné rutiny události pro Click událost druhé položky nabídky přidané do kolekce. Kód pak přiřadí mainMenu1Menu vlastnost objektu Form. Tento příklad vyžaduje, aby se kód definovaný v tomto příkladu nacházel ve formuláři.

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

Poznámky

A MenuItem může být současně obsažen pouze v jedné nabídce a nelze jej přidat více než jednou do stejné nabídky. Chcete-li znovu použít MenuItem ve více než jedné nabídce, použijte CloneMenu metodu MenuItem třídy . Pokud chcete odebrat MenuItem objekt, který jste přidali dříve, použijte metodu Remove .

Tato verze Add metody umožňuje určit popis pro položku nabídky a delegáta pro zpracování Click události. Tuto verzi metody můžete použít, Add pokud vaše aplikace již má obslužnou rutinu Click události pro zpracování události.

Poznámka

Událost Click není vyvolána pro objekt MenuItem , který obsahuje položky podnabídky.

Viz také

Platí pro

Add(String, MenuItem[])

Přidá na konec této nabídky nový MenuItem se zadanými popis, Click obslužnou rutinou události a položkami.

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

Parametry

caption
String

Popis položky nabídky.

items
MenuItem[]

Pole MenuItem objektů, které bude obsahovat MenuItem .

Návraty

MenuItem

A MenuItem představující položku nabídky, která se přidává do kolekce.

Poznámky

A MenuItem může být současně obsažen pouze v jedné nabídce a nelze jej přidat více než jednou do stejné nabídky. Chcete-li znovu použít MenuItem ve více než jedné nabídce, použijte CloneMenu metodu MenuItem třídy . Pokud chcete odebrat MenuItem objekt, který jste přidali dříve, použijte metodu Remove .

Tato verze Add metody umožňuje určit popis pro položku nabídky a delegáta, který bude zpracovávat jeho Click událost. Tuto verzi metody můžete použít, Add pokud vaše aplikace již má obslužnou rutinu Click události pro zpracování události. Tato verze metody také umožňuje zadat pole dříve vytvořených MenuItem objektů, které chcete přidat do kolekce. Tuto funkci můžete použít k opakovanému použití existujících MenuItem objektů, které byly naklonovány pomocí CloneMenu metody . items Pokud parametr není prázdný nebo null, MenuItem bude přidání do kolekce obsahovat položky podnabídky.

Poznámka

Událost Click není vyvolána pro objekt MenuItem , který obsahuje položky podnabídky.

Viz také

Platí pro