Menu.MenuItemCollection.Add Metoda

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá novou MenuItem kolekci.

Přetížení

Name	Description
Add(String)	Přidá na konec aktuální nabídky nový MenuItem, se zadaným titulkem.
Add(MenuItem)	Přidá dříve vytvořenou MenuItem na konec aktuální nabídky.
Add(Int32, MenuItem)	Přidá dříve vytvořenou 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 titulkem a zadanou obslužnou rutinou Click události události.
Add(String, MenuItem[])	Přidá na konec této nabídky nový MenuItem popisek, Click obslužnou rutinu události a položky.

Zdroj:: Menu.MenuItemCollection.cs

Zdroj:: Menu.MenuItemCollection.cs

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

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

Titulek 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í mainMenu1 vlastnost Menu 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 obsažena pouze v jedné nabídce najednou a nelze ji přidat více než jednou do stejné nabídky. Pokud chcete znovu použít MenuItem více než jednu nabídku, použijte CloneMenu metodu MenuItem třídy. Pokud chcete odebrat dříve přidanou položku MenuItem , použijte metodu Remove .

Viz také

Remove(MenuItem)

Platí pro

Zdroj:: Menu.MenuItemCollection.cs

Zdroj:: Menu.MenuItemCollection.cs

Přidá dříve vytvořenou MenuItem 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ání MenuItem

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

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

Viz také

Remove(MenuItem)

Platí pro

Zdroj:: Menu.MenuItemCollection.cs

Zdroj:: Menu.MenuItemCollection.cs

Přidá dříve vytvořenou 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ání MenuItem

Návraty

Int32

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

Výjimky

Exception

Přidání MenuItem 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

Tato verze Add metody umožňuje přidat dříve vytvořené MenuItem objekty do konkrétního umístění indexu v kolekci. Všechny MenuItem aktuálně umístěné v 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é

Remove(MenuItem)

Platí pro

Zdroj:: Menu.MenuItemCollection.cs

Zdroj:: Menu.MenuItemCollection.cs

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

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

Titulek položky nabídky.

onClick: EventHandler

Představuje EventHandler obslužnou rutinu události, která je volána při kliknutí na položku uživatelem 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í mainMenu1 vlastnost Menu 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", 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

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

Poznámka:

Událost Click není vyvolána pro MenuItem položky, které obsahují podnabídky.

Viz také

Remove(MenuItem)

Platí pro

Zdroj:: Menu.MenuItemCollection.cs

Zdroj:: Menu.MenuItemCollection.cs

Přidá na konec této nabídky nový MenuItem popisek, Click obslužnou rutinu události a položky.

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

Titulek položky nabídky.

items: MenuItem[]

Pole MenuItem objektů, které budou MenuItem obsahovat.

Návraty

MenuItem

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

Poznámky

Tato verze Add metody umožňuje zadat titulek položky nabídky a delegáta, který bude zpracovávat jeho Click událost. Tuto verzi Add metody můžete použít, pokud vaše aplikace již má obslužnou rutinu události pro zpracování Click 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 nullMenuItem , bude přidání do kolekce obsahovat podnabídky.

Poznámka:

Událost Click není vyvolána pro MenuItem položky, které obsahují podnabídky.

Viz také

Remove(MenuItem)

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

Menu.MenuItemCollection.Add Metoda

Definice

Přetížení

Add(String)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Add(MenuItem)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Add(Int32, MenuItem)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Add(String, EventHandler)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Add(String, MenuItem[])

Parametry

Návraty

Poznámky

Viz také

Platí pro

Váš názor