Menu.MenuItemCollection.Add Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Koleksiyona yeni MenuItem bir ekler.

Aşırı Yüklemeler

Add(String)	Geçerli menünün sonuna belirtilen başlık MenuItemyeni bir ekler.
Add(MenuItem)	Geçerli menünün sonuna önceden oluşturulmuş MenuItem bir ekler.
Add(Int32, MenuItem)	Menü öğesi koleksiyonu içinde belirtilen dizinde daha önce oluşturulmuş MenuItem bir ekler.
Add(String, EventHandler)	Geçerli menünün sonuna belirtilen başlık ve olay için belirtilen olay işleyicisiyle Click yeni MenuItem bir ekler.
Add(String, MenuItem[])	Belirtilen başlık, Click olay işleyicisi ve öğelerle bu menünün sonuna yeni MenuItem bir ekler.

Geçerli menünün sonuna belirtilen başlık MenuItemyeni bir ekler.

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

Parametreler

caption: String

Menü öğesinin başlık.

Döndürülenler

MenuItem

MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.

Örnekler

Aşağıdaki kod örneği, mainMenu1türetilmiş sınıfını MainMenu kullanarak koleksiyonuna iki MenuItem nesne eklenmiş MenuItems olan bir ana menü oluşturur. Kod daha sonra özelliğini Formatar mainMenu1Menu. Bu örnekte tanımlanan kodun formda bulunması gerekir.

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

Açıklamalar

bir MenuItem kerede yalnızca bir menüde bulunabilir ve aynı menüye birden çok kez eklenemez. Birden fazla menüde yeniden MenuItem kullanmak için sınıfının yöntemini MenuItem kullanınCloneMenu. Daha önce eklediğiniz bir MenuItem öğesini kaldırmak için yöntemini kullanın Remove .

Ayrıca bkz.

Remove(MenuItem)

Şunlara uygulanır

Geçerli menünün sonuna önceden oluşturulmuş MenuItem bir ekler.

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

Parametreler

item: MenuItem

MenuItem Eklenecek.

Döndürülenler

Int32

Öğenin koleksiyonda depolandığı sıfır tabanlı dizin.

Örnekler

Aşağıdaki kod örneği, MainMenutüretilmiş sınıfının bir örneğini oluşturur ve nesne koleksiyonuna MenuItem bir MenuItem ekler. Bu örnek, bu örnekte tanımlanan yöntemin bir formun sınıfında yer alıp bu form sınıfındaki bir yöntem tarafından çağrılır.

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

Açıklamalar

Yöntemin Add bu sürümü, menü öğesi koleksiyonunun sonuna önceden oluşturulmuş MenuItem nesneler eklemenize olanak tanır.

Ayrıca bkz.

Remove(MenuItem)

Şunlara uygulanır

Menü öğesi koleksiyonu içinde belirtilen dizinde daha önce oluşturulmuş MenuItem bir ekler.

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

Parametreler

index: Int32

Yeni öğenin ekleneceği konum.

item: MenuItem

MenuItem Eklenecek.

Döndürülenler

Int32

Öğenin koleksiyonda depolandığı sıfır tabanlı dizin.

Özel durumlar

Exception

MenuItem Eklenen zaten kullanımda.

ArgumentException

parametresinde index sağlanan dizin koleksiyonun boyutundan daha büyük.

Örnekler

Aşağıdaki kod örneği türetilmiş MainMenusınıfının bir örneğini oluşturur ve menü öğesi koleksiyonunda belirli bir konumdaki nesne koleksiyonuna MenuItem bir MenuItem nesnesi ekler. Bu örnek, bu örnekte tanımlanan yöntemin bir formun sınıfında yer alıp bu form sınıfındaki bir yöntem tarafından çağrılır.

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

Açıklamalar

Yönteminin Add bu sürümü, daha önce oluşturulmuş MenuItem nesneleri koleksiyon içindeki belirli bir dizin konumuna eklemenize olanak tanır. Şu anda bu dizinde bulunan tüm MenuItem nesneler ve bu dizinden sonraki tüm MenuItem nesneler koleksiyondaki bir sonraki en düşük dizine taşınır.

Ayrıca bkz.

Remove(MenuItem)

Şunlara uygulanır

Geçerli menünün sonuna belirtilen başlık ve olay için belirtilen olay işleyicisiyle Click yeni MenuItem bir ekler.

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

Parametreler

caption: String

Menü öğesinin başlık.

onClick: EventHandler

Öğeye EventHandler kullanıcı tarafından tıklandığında veya bir kullanıcı menü öğesi için bir hızlandırıcıya veya kısayol tuşuna bastığında çağrılan olay işleyicisini temsil eden bir.

Döndürülenler

MenuItem

MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.

Örnekler

Aşağıdaki kod örneği, mainMenu1türetilmiş sınıfını MainMenu kullanarak koleksiyonuna iki MenuItem nesne eklenmiş MenuItems olan bir ana menü oluşturur. Kod, yöntemin Add bu sürümünü kullanarak koleksiyona eklenen ikinci menü öğesinin Click olayı için bir olay işleyicisi tanımlar. Kod daha sonra özelliğini Formatar mainMenu1Menu. Bu örnekte tanımlanan kodun bir formda bulunması gerekir.

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

Açıklamalar

Yöntemin Add bu sürümü, menü öğesi için bir başlık ve olayı işlemek Click için bir temsilci belirtmenize olanak tanır. Uygulamanızın Add olayı işlemek için zaten bir olay işleyicisi varsa yöntemin Click bu sürümünü kullanabilirsiniz.

Not

Olay Click , alt menü öğelerini içeren bir MenuItem için tetiklenmez.

Ayrıca bkz.

Remove(MenuItem)

Şunlara uygulanır

Belirtilen başlık, Click olay işleyicisi ve öğelerle bu menünün sonuna yeni MenuItem bir ekler.

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

Parametreler

caption: String

Menü öğesinin başlık.

items: MenuItem[]

Bunun MenuItem içereceği bir nesne dizisiMenuItem.

Döndürülenler

MenuItem

MenuItem Koleksiyona eklenen menü öğesini temsil eden bir.

Açıklamalar

Yöntemin Add bu sürümü, menü öğesi için bir başlık ve olayını işleyecek bir temsilci belirtmenize Click olanak tanır. Uygulamanızın Add olayı işlemek için zaten bir olay işleyicisi varsa yöntemin Click bu sürümünü kullanabilirsiniz. Yöntemin bu sürümü, koleksiyona eklemek istediğiniz önceden oluşturulmuş MenuItem bir nesne dizisi belirtmenize de olanak tanır. Yöntemi kullanılarak CloneMenu kopyalanmış mevcut MenuItem nesneleri yeniden kullanmak için bu özelliği kullanabilirsiniz. items parametresi veya nullMenuItem boş değilse, koleksiyona eklenen alt menü öğelerini içerir.

Not

Olay Click , alt menü öğelerini içeren bir MenuItem için tetiklenmez.

Ayrıca bkz.

Remove(MenuItem)

Şunlara uygulanır

Aracılığıyla paylaş

Menu.MenuItemCollection.Add Yöntem

Tanım

Aşırı Yüklemeler

Add(String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(MenuItem)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(Int32, MenuItem)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, EventHandler)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, MenuItem[])

Parametreler

Döndürülenler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar