Menu.MenuItemCollection.Add Metodo

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

Restituisce

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)

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

Restituisce

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)

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

Restituisce

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

Eccezioni

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)

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

Restituisce

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 .

Vedi anche

• Remove(MenuItem)

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

Restituisce

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.

Vedi anche

• Remove(MenuItem)