Menu.MenuItemCollection.Add Metode

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan baru MenuItem ke koleksi.

Overload

Nama	Deskripsi
Add(String)	MenuItemMenambahkan baru , ke akhir menu saat ini, dengan keterangan tertentu.
Add(MenuItem)	Menambahkan yang sebelumnya dibuat MenuItem ke akhir menu saat ini.
Add(Int32, MenuItem)	Menambahkan yang sebelumnya dibuat MenuItem pada indeks yang ditentukan dalam kumpulan item menu.
Add(String, EventHandler)	Menambahkan baru MenuItem ke akhir menu saat ini dengan keterangan tertentu dan penanganan aktivitas tertentu untuk peristiwa tersebut Click .
Add(String, MenuItem[])	Menambahkan baru MenuItem ke akhir menu ini dengan keterangan, penanganan aktivitas, Click dan item yang ditentukan.

Sumber:: Menu.MenuItemCollection.cs

Sumber:: Menu.MenuItemCollection.cs

MenuItemMenambahkan baru , ke akhir menu saat ini, dengan keterangan tertentu.

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

Keterangan 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 ditetapkan 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 pada satu waktu, 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 sebelumnya telah Anda tambahkan, gunakan metode .Remove

Lihat juga

Remove(MenuItem)

Berlaku untuk

Sumber:: Menu.MenuItemCollection.cs

Sumber:: Menu.MenuItemCollection.cs

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 kumpulan MenuItem objeknya. Contoh ini mengharuskan metode yang ditentukan dalam contoh ini terletak di dalam kelas untuk formulir dan dipanggil oleh metode di 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

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

Lihat juga

Remove(MenuItem)

Berlaku untuk

Sumber:: Menu.MenuItemCollection.cs

Sumber:: Menu.MenuItemCollection.cs

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

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

Lihat juga

Remove(MenuItem)

Berlaku untuk

Sumber:: Menu.MenuItemCollection.cs

Sumber:: Menu.MenuItemCollection.cs

Menambahkan baru MenuItem ke akhir menu saat ini dengan keterangan tertentu dan penanganan aktivitas tertentu untuk peristiwa tersebut 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

Parameter

caption: String

Keterangan item menu.

onClick: EventHandler

Yang EventHandler mewakili penanganan aktivitas yang dipanggil saat item diklik oleh pengguna, atau ketika pengguna menekan tombol akselerator atau 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 ditetapkan 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

Versi Add metode ini memungkinkan Anda menentukan keterangan 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.

Nota

Peristiwa Click tidak dimunculkan untuk item MenuItem submenu yang berisi.

Lihat juga

Remove(MenuItem)

Berlaku untuk

Sumber:: Menu.MenuItemCollection.cs

Sumber:: Menu.MenuItemCollection.cs

Menambahkan baru MenuItem ke akhir menu ini dengan keterangan, 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

Keterangan item menu.

items: MenuItem[]

Array MenuItem objek yang akan dimuat ini MenuItem .

Mengembalikan

MenuItem

MenuItem Yang mewakili item menu yang ditambahkan ke koleksi.

Keterangan

Versi Add metode ini memungkinkan Anda menentukan keterangan untuk item menu dan delegasi yang akan menangani peristiwanya Click . 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.

Nota

Peristiwa Click tidak dimunculkan untuk item MenuItem submenu yang berisi.

Lihat juga

Remove(MenuItem)

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

Menu.MenuItemCollection.Add Metode

Definisi

Overload

Add(String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(MenuItem)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(Int32, MenuItem)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(String, EventHandler)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(String, MenuItem[])

Parameter

Mengembalikan

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar