Bagikan melalui

Menu.MenuItemCollection.Add Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Menambahkan baru MenuItem ke koleksi.

Overload

Add(String)

Menambahkan , baru MenuItemke akhir menu saat ini, dengan caption yang ditentukan.
Add(MenuItem)

Menambahkan yang sebelumnya dibuat MenuItem ke akhir menu saat ini.
Add(Int32, MenuItem)

Menambahkan yang dibuat sebelumnya MenuItem pada indeks yang ditentukan dalam koleksi item menu.
Add(String, EventHandler)

Menambahkan baru MenuItem ke akhir menu saat ini dengan caption tertentu dan penanganan aktivitas tertentu untuk peristiwa tersebutClick.
Add(String, MenuItem[])

Menambahkan baru MenuItem ke akhir menu ini dengan caption, penanganan aktivitas, Click dan item yang ditentukan.

Add(String)

Menambahkan , baru MenuItemke akhir menu saat ini, dengan caption yang ditentukan.

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

Parameter

caption
String

Caption item menu.

Mengembalikan

MenuItem

MenuItem yang mewakili item menu yang ditambahkan ke koleksi.

Contoh

Contoh kode berikut menggunakan kelas MainMenu turunan untuk membuat menu utama, mainMenu1, yang memiliki dua MenuItem objek yang ditambahkan ke koleksinya MenuItems . Kode kemudian menetapkan mainMenu1 ke Menu properti dari Form. Contoh ini mengharuskan kode yang ditentukan dalam contoh ini terletak dengan dalam formulir.

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

Keterangan

hanya MenuItem dapat dimuat dalam satu menu sekaligus, dan tidak dapat ditambahkan lebih dari sekali ke menu yang sama. Untuk menggunakan MenuItem kembali di lebih dari satu menu, gunakan CloneMenu metode MenuItem kelas . Untuk menghapus MenuItem yang telah Anda tambahkan sebelumnya, gunakan metode .Remove

Lihat juga

Berlaku untuk

Add(MenuItem)

Menambahkan yang sebelumnya dibuat MenuItem ke akhir menu saat ini.

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

Parameter

item
MenuItem

yang MenuItem akan ditambahkan.

Mengembalikan

Int32

Indeks berbasis nol tempat item disimpan dalam koleksi.

Contoh

Contoh kode berikut membuat instans kelas turunan, MainMenu, dan menambahkan MenuItem ke koleksi MenuItem objeknya. Contoh ini mengharuskan metode yang ditentukan dalam contoh ini terletak di dalam kelas untuk formulir dan dipanggil oleh metode dalam kelas formulir tersebut.

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

Keterangan

hanya MenuItem dapat dimuat dalam satu menu sekaligus, dan tidak dapat ditambahkan lebih dari sekali ke menu yang sama. Untuk menggunakan MenuItem kembali di lebih dari satu menu, gunakan CloneMenu metode MenuItem kelas . Untuk menghapus MenuItem yang telah Anda tambahkan sebelumnya, gunakan metode .Remove

Versi Add metode ini memungkinkan Anda menambahkan objek yang dibuat MenuItem sebelumnya ke akhir koleksi item menu.

Lihat juga

Berlaku untuk

Add(Int32, MenuItem)

Menambahkan yang dibuat sebelumnya MenuItem pada indeks yang ditentukan dalam koleksi item 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

Parameter

index
Int32

Posisi untuk menambahkan item baru.

item
MenuItem

yang MenuItem akan ditambahkan.

Mengembalikan

Int32

Indeks berbasis nol tempat item disimpan dalam koleksi.

Pengecualian

Exception

Yang MenuItem ditambahkan sudah digunakan.

ArgumentException

Indeks yang disediakan dalam index parameter lebih besar dari ukuran koleksi.

Contoh

Contoh kode berikut membuat instans kelas turunan, MainMenu, dan menambahkan MenuItem objek ke koleksi MenuItem objeknya di lokasi tertentu di koleksi item menu. Contoh ini mengharuskan metode yang ditentukan dalam contoh ini terletak di dalam kelas untuk formulir dan dipanggil oleh metode dalam kelas formulir tersebut.

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

Keterangan

hanya MenuItem dapat dimuat dalam satu menu sekaligus, dan tidak dapat ditambahkan lebih dari sekali ke menu yang sama. Untuk menggunakan MenuItem kembali di lebih dari satu menu, gunakan CloneMenu metode MenuItem kelas . Untuk menghapus MenuItem yang telah Anda tambahkan sebelumnya, gunakan metode .Remove

Versi Add metode ini memungkinkan Anda menambahkan objek yang dibuat MenuItem sebelumnya ke lokasi indeks tertentu dalam koleksi. Setiap MenuItem yang saat ini terletak di indeks tersebut, dan semua MenuItem objek setelah indeks tersebut, dipindahkan ke indeks terendah berikutnya dalam koleksi.

Lihat juga

Berlaku untuk

Add(String, EventHandler)

Menambahkan baru MenuItem ke akhir menu saat ini dengan caption tertentu dan penanganan aktivitas tertentu untuk peristiwa tersebutClick.

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

Parameter

caption
String

Caption item menu.

onClick
EventHandler

Yang EventHandler mewakili penanganan aktivitas yang dipanggil saat item diklik oleh pengguna, atau ketika pengguna menekan akselerator atau tombol pintasan untuk item menu.

Mengembalikan

MenuItem

MenuItem yang mewakili item menu yang ditambahkan ke koleksi.

Contoh

Contoh kode berikut menggunakan kelas MainMenu turunan untuk membuat menu utama, mainMenu1, yang memiliki dua MenuItem objek yang ditambahkan ke koleksinya MenuItems . Kode menggunakan versi Add metode ini untuk menentukan penanganan aktivitas untuk Click peristiwa item menu kedua yang ditambahkan ke koleksi. Kode kemudian menetapkan mainMenu1 ke Menu properti dari Form. Contoh ini mengharuskan kode yang ditentukan dalam contoh ini terletak dalam formulir.

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

Keterangan

hanya MenuItem dapat dimuat dalam satu menu sekaligus, dan tidak dapat ditambahkan lebih dari sekali ke menu yang sama. Untuk menggunakan MenuItem kembali di lebih dari satu menu, gunakan CloneMenu metode MenuItem kelas . Untuk menghapus MenuItem yang telah Anda tambahkan sebelumnya, gunakan metode .Remove

Versi Add metode ini memungkinkan Anda menentukan caption untuk item menu dan delegasi untuk menangani Click peristiwa. Anda dapat menggunakan versi Add metode ini jika aplikasi Anda sudah memiliki penanganan aktivitas untuk menangani Click peristiwa.

Catatan

Peristiwa Click tidak dimunculkan untuk yang MenuItem berisi item submenu.

Lihat juga

Berlaku untuk

Add(String, MenuItem[])

Menambahkan baru MenuItem ke akhir menu ini dengan caption, penanganan aktivitas, Click dan item yang ditentukan.

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

Parameter

caption
String

Caption item menu.

items
MenuItem[]

Array MenuItem objek yang akan dimuat ini MenuItem .

Mengembalikan

MenuItem

MenuItem yang mewakili item menu yang ditambahkan ke koleksi.

Keterangan

hanya MenuItem dapat dimuat dalam satu menu sekaligus, dan tidak dapat ditambahkan lebih dari sekali ke menu yang sama. Untuk menggunakan MenuItem kembali di lebih dari satu menu, gunakan CloneMenu metode MenuItem kelas . Untuk menghapus MenuItem yang telah Anda tambahkan sebelumnya, gunakan metode .Remove

Versi Add metode ini memungkinkan Anda menentukan caption untuk item menu dan delegasi yang akan menangani peristiwanyaClick. Anda dapat menggunakan versi Add metode ini jika aplikasi Anda sudah memiliki penanganan aktivitas untuk menangani Click peristiwa. Versi metode ini juga memungkinkan Anda menentukan array objek yang dibuat MenuItem sebelumnya yang ingin Anda tambahkan ke koleksi. Anda dapat menggunakan fitur ini untuk menggunakan kembali objek yang ada yang telah dikloning MenuItem menggunakan metode .CloneMenu items Jika parameter tidak kosong atau null, yang MenuItem ditambahkan ke koleksi akan berisi item submenu.

Catatan

Peristiwa Click tidak dimunculkan untuk yang MenuItem berisi item submenu.

Lihat juga

Berlaku untuk