Menu.MenuItemCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge un nuovo oggetto MenuItem alla raccolta.

Overload

Add(String)	Aggiunge un nuovo MenuItem alla fine del menu corrente, con una didascalia specificata.
Add(MenuItem)	Aggiunge un oggetto MenuItem precedentemente creato alla fine del menu corrente.
Add(Int32, MenuItem)	Aggiunge un oggetto MenuItem precedentemente creato nell'indice specificato, all'interno dell'insieme delle voci di menu.
Add(String, EventHandler)	Aggiunge un nuovo MenuItem alla fine del menu corrente, con una didascalia specificata e un gestore eventi specificato per l'evento Click.
Add(String, MenuItem[])	Aggiunge un nuovo oggetto MenuItem alla fine del menu corrente, con la didascalia specificata, il gestore dell'evento Click e le voci.

Add(String)

Aggiunge un nuovo MenuItem alla fine del menu corrente, con una didascalia specificata.

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

Parametri

caption

String

La didascalia della voce di menu.

Restituisce

MenuItem

Oggetto MenuItem che rappresenta la voce di menu aggiunta all'insieme.

Esempio

Nell'esempio di codice seguente viene utilizzata la classe MainMenu derivata per creare un menu principale, mainMenu1, con due MenuItem oggetti aggiunti alla raccolta MenuItems . Il codice assegna mainMenu1 quindi alla Menu proprietà dell'oggetto Form. Questo esempio richiede che il codice definito in questo esempio si trovi in un modulo.

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

Commenti

Un MenuItem oggetto può essere contenuto in un solo menu alla volta e non può essere aggiunto più volte allo stesso menu. Per riutilizzare un MenuItem oggetto in più menu, usare il CloneMenu metodo della MenuItem classe . Per rimuovere un MenuItem oggetto aggiunto in precedenza, usare il Remove metodo .

Vedi anche

• Remove(MenuItem)

Add(MenuItem)

Aggiunge un oggetto MenuItem precedentemente creato alla fine del menu corrente.

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

Parametri

item

MenuItem

Oggetto MenuItem da aggiungere.

Restituisce

Int32

Indice in base zero in cui l'elemento viene memorizzato nell'insieme.

Esempio

Nell'esempio di codice seguente viene creata un'istanza della classe derivata , MainMenue viene aggiunto un oggetto MenuItem alla raccolta di MenuItem oggetti . In questo esempio è necessario che il metodo definito in questo esempio si trovi all'interno della classe per una maschera e chiamato da un metodo nella classe del modulo.

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

Commenti

Un MenuItem oggetto può essere contenuto in un solo menu alla volta e non può essere aggiunto più volte allo stesso menu. Per riutilizzare un MenuItem oggetto in più menu, usare il CloneMenu metodo della MenuItem classe . Per rimuovere un MenuItem oggetto aggiunto in precedenza, usare il Remove metodo .

Questa versione del Add metodo consente di aggiungere oggetti creati MenuItem in precedenza alla fine dell'insieme di voci di menu.

Vedi anche

• Remove(MenuItem)

Add(Int32, MenuItem)

Aggiunge un oggetto MenuItem precedentemente creato nell'indice specificato, all'interno dell'insieme delle voci di menu.

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

Parametri

index

Int32

La posizione in cui aggiungere la nuova voce.

item

MenuItem

Oggetto MenuItem da aggiungere.

Restituisce

Int32

Indice in base zero in cui l'elemento viene memorizzato nell'insieme.

Eccezioni

Exception

L'oggetto MenuItem da aggiungere è già in uso.

ArgumentException

L'indice fornito nel parametro index è più grande delle dimensioni dell'insieme.

Esempio

Nell'esempio di codice seguente viene creata un'istanza della classe derivata , MainMenue viene aggiunto un MenuItem oggetto alla raccolta di oggetti in una posizione specifica nell'insieme di voci di MenuItem menu. In questo esempio è necessario che il metodo definito in questo esempio si trovi all'interno della classe per una maschera e chiamato da un metodo nella classe del modulo.

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

Commenti

Un MenuItem oggetto può essere contenuto in un solo menu alla volta e non può essere aggiunto più volte allo stesso menu. Per riutilizzare un MenuItem oggetto in più menu, usare il CloneMenu metodo della MenuItem classe . Per rimuovere un MenuItem oggetto aggiunto in precedenza, usare il Remove metodo .

Questa versione del Add metodo consente di aggiungere oggetti creati MenuItem in precedenza a una posizione di indice specifica all'interno della raccolta. Tutti MenuItem gli oggetti attualmente presenti in tale indice e tutti gli MenuItem oggetti dopo tale indice vengono spostati nell'indice più basso successivo dell'insieme.

Vedi anche

• Remove(MenuItem)

Add(String, EventHandler)

Aggiunge un nuovo MenuItem alla fine del menu corrente, con una didascalia specificata e un gestore eventi specificato per l'evento Click.

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

Parametri

caption

String

La didascalia della voce di menu.

onClick

EventHandler

Oggetto EventHandler che rappresenta il gestore eventi chiamato quando l'utente fa clic sulla voce o quando preme un tasto di scelta rapida per la voce di menu.

Restituisce

MenuItem

Oggetto MenuItem che rappresenta la voce di menu aggiunta all'insieme.

Esempio

Nell'esempio di codice seguente viene utilizzata la classe MainMenu derivata per creare un menu principale, mainMenu1, con due MenuItem oggetti aggiunti alla raccolta MenuItems . Il codice usa questa versione del Add metodo per definire un gestore eventi per l'evento Click della seconda voce di menu aggiunta alla raccolta. Il codice assegna mainMenu1 quindi alla Menu proprietà dell'oggetto Form. Questo esempio richiede che il codice definito in questo esempio si trovi all'interno di un modulo.

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

Commenti

Un MenuItem oggetto può essere contenuto in un solo menu alla volta e non può essere aggiunto più volte allo stesso menu. Per riutilizzare un MenuItem oggetto in più menu, usare il CloneMenu metodo della MenuItem classe . Per rimuovere un MenuItem oggetto aggiunto in precedenza, usare il Remove metodo .

Questa versione del Add metodo consente di specificare un didascalia per la voce di menu e un delegato per gestire l'eventoClick. È possibile usare questa versione del metodo se l'applicazione Add dispone già di un gestore eventi per gestire l'evento Click .

Nota

L'evento Click non viene generato per un MenuItem oggetto che contiene elementi di sottomenu.

Vedi anche

• Remove(MenuItem)

Add(String, MenuItem[])

Aggiunge un nuovo oggetto MenuItem alla fine del menu corrente, con la didascalia specificata, il gestore dell'evento Click e le voci.

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

Parametri

caption

String

La didascalia della voce di menu.

items

MenuItem[]

Matrice di oggetti MenuItem che sarà contenuta da questo MenuItem.

Restituisce

MenuItem

Oggetto MenuItem che rappresenta la voce di menu aggiunta all'insieme.

Commenti

Un MenuItem oggetto può essere contenuto in un solo menu alla volta e non può essere aggiunto più volte allo stesso menu. Per riutilizzare un MenuItem oggetto in più menu, usare il CloneMenu metodo della MenuItem classe . Per rimuovere un MenuItem oggetto aggiunto in precedenza, usare il Remove metodo .

Questa versione del Add metodo consente di specificare un didascalia per la voce di menu e un delegato che gestirà l'eventoClick. È possibile usare questa versione del metodo se l'applicazione Add dispone già di un gestore eventi per gestire l'evento Click . Questa versione del metodo consente inoltre di specificare una matrice di oggetti creati MenuItem in precedenza da aggiungere alla raccolta. È possibile usare questa funzionalità per riutilizzare gli oggetti esistenti MenuItem clonati usando il CloneMenu metodo . Se il items parametro non è vuoto o null, l'oggetto MenuItem da aggiungere all'insieme conterrà elementi di sottomenu.

Nota

L'evento Click non viene generato per un MenuItem oggetto che contiene elementi di sottomenu.

Vedi anche

• Remove(MenuItem)