MenuItem Konstruktor

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menginisialisasi instans baru kelas MenuItem.

Overload

MenuItem()	Menginisialisasi MenuItem dengan caption kosong.
MenuItem(String)	Menginisialisasi instans MenuItem baru kelas dengan caption tertentu untuk item menu.
MenuItem(String, EventHandler)	Menginisialisasi instans baru kelas dengan caption dan penanganan aktivitas tertentu untuk Click peristiwa item menu.
MenuItem(String, MenuItem[])	Menginisialisasi instans baru kelas dengan caption tertentu dan array item submenu yang ditentukan untuk item menu.
MenuItem(String, EventHandler, Shortcut)	Menginisialisasi instans baru kelas dengan caption tertentu, penanganan aktivitas, dan kunci pintasan terkait untuk item menu.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Menginisialisasi instans MenuItem baru kelas dengan caption tertentu; penanganan aktivitas yang ditentukan untuk Click, Select dan Popup peristiwa; kunci pintasan; jenis penggabungan; dan urutan yang ditentukan untuk item menu.

MenuItem()

Menginisialisasi MenuItem dengan caption kosong.

public:
 MenuItem();

public MenuItem ();

Public Sub New ()

Contoh

Contoh kode berikut membuat MenuItem menggunakan versi konstruktor ini.

public:
   void CreateMyMenu()
   {
      // Create an empty menu item object.
      MenuItem^ menuItem1 = gcnew MenuItem;
      // Intialize the menu item using the parameterless version of the constructor.
      // Set the caption of the menu item.
      menuItem1->Text = "&File";
   }

public void CreateMyMenu()
{
   // Create an empty menu item object.
   MenuItem menuItem1 = new MenuItem();
   // Intialize the menu item using the parameterless version of the constructor.
   // Set the caption of the menu item.
   menuItem1.Text = "&File";
}

Public Sub CreateMyMenu()
    ' Create an empty menu item object.
    Dim menuItem1 As New MenuItem()
    ' Intialize the menu item using the parameterless version of the constructor.
    ' Set the caption of the menu item.
    menuItem1.Text = "&File"
End Sub

Keterangan

Setelah Anda membuat kosong MenuItem menggunakan konstruktor ini, Anda dapat menggunakan properti dan metode MenuItem kelas untuk menentukan tampilan dan perilaku Anda MenuItem.

MenuItem(String)

Menginisialisasi instans MenuItem baru kelas dengan caption tertentu untuk item menu.

public:
 MenuItem(System::String ^ text);

public MenuItem (string text);

new System.Windows.Forms.MenuItem : string -> System.Windows.Forms.MenuItem

Public Sub New (text As String)

Parameter

text

String

Caption untuk item menu.

Contoh

Contoh kode berikut membuat MenuItem yang menentukan caption item menu pada saat dibuat.

public:
   void CreateMyMenus()
   {
      // Create an instance of a MenuItem with a specified caption.
      menuItem1 = gcnew MenuItem( "&File" );
   }

public void CreateMyMenus()
{
   // Create an instance of a MenuItem with a specified caption.
   menuItem1 = new MenuItem("&File");
}

Public Sub CreateMyMenus()
    ' Create an instance of a MenuItem with a specified caption.
    menuItem1 = New MenuItem("&File")
End Sub

Keterangan

Saat menentukan caption untuk item menu dengan text parameter , Anda juga dapat menentukan kunci akses dengan menempatkan karakter '&' sebelum karakter digunakan sebagai kunci akses. Misalnya, untuk menentukan "F" dalam "File" sebagai kunci akses, Anda akan menentukan caption untuk item menu sebagai "file &". Anda dapat menggunakan fitur ini untuk menyediakan navigasi keyboard untuk menu Anda.

text Mengatur parameter ke "-" menyebabkan item menu Anda ditampilkan sebagai pemisah (garis horizontal) daripada item menu standar.

MenuItem(String, EventHandler)

Menginisialisasi instans baru kelas dengan caption dan penanganan aktivitas tertentu untuk Click peristiwa item menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick);

public MenuItem (string text, EventHandler onClick);

new System.Windows.Forms.MenuItem : string * EventHandler -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler)

Parameter

text

String

Caption untuk item menu.

onClick

EventHandler

yang EventHandler menangani Click kejadian untuk item menu ini.

Contoh

Contoh kode berikut membuat MenuItem objek dengan caption tertentu dan delegasi yang EventHandler tersambung ke penanganan aktivitas yang akan menangani Click peristiwa untuk item menu.

public:
   void CreateMyMenuItem()
   {
      // Create an instance of MenuItem with caption and an event handler
      MenuItem^ menuItem1 = gcnew MenuItem( "&New",gcnew System::EventHandler(
         this, &Form1::MenuItem1_Click ) );
   }

private:
   // This method is an event handler for menuItem1 to use when connecting its event handler.
   void MenuItem1_Click( Object^ sender, System::EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create an instance of MenuItem with caption and an event 
    ' handler
    Dim MenuItem1 As New MenuItem("&New", New _
        System.EventHandler(AddressOf Me.MenuItem1_Click))
End Sub
' This method is an event handler for MenuItem1 to use when 
' connecting its event handler.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal _
    e as System.EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Keterangan

Saat menentukan caption untuk item menu dengan text parameter , Anda juga dapat menentukan kunci akses dengan menempatkan '&' sebelum karakter digunakan sebagai kunci akses. Misalnya, untuk menentukan "F" dalam "File" sebagai kunci akses, Anda akan menentukan caption untuk item menu sebagai "file &". Anda dapat menggunakan fitur ini untuk menyediakan navigasi keyboard untuk menu Anda.

text Mengatur parameter ke "-" menyebabkan item menu Anda ditampilkan sebagai pemisah (garis horizontal) daripada item menu standar.

Selain itu, Anda dapat menggunakan konstruktor ini untuk menentukan delegasi yang akan menangani Click peristiwa untuk item menu yang sedang dibuat. EventHandler yang Anda berikan ke konstruktor ini harus dikonfigurasi untuk memanggil penanganan aktivitas yang dapat menangani Click peristiwa. Untuk informasi selengkapnya tentang penanganan peristiwa, lihat Menangani dan Menaikkan Peristiwa.

MenuItem(String, MenuItem[])

Menginisialisasi instans baru kelas dengan caption tertentu dan array item submenu yang ditentukan untuk item menu.

public:
 MenuItem(System::String ^ text, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (string text, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (text As String, items As MenuItem())

Parameter

text

String

Caption untuk item menu.

items

MenuItem[]

Array MenuItem objek yang berisi item submenu untuk item menu ini.

Contoh

Contoh kode berikut membuat objek dengan caption tertentu, penanganan aktivitas yang tersambung ke metode yang akan menangani peristiwa setiap item menu dalam array item submenu.

public:
   void CreateMyMenuItem()
   {
      // submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      // Create an instance of a MenuItem with caption and an array of submenu
      // items specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&Colors",subMenus );
   }

public void CreateMyMenuItem()
{
   // submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");
   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   // Create an instance of a MenuItem with caption and an array of submenu
   // items specified.
   MenuItem MenuItem1 = new MenuItem("&Colors", subMenus);
}

Public Sub CreateMyMenuItem()
    ' submenu item array.
    Dim subMenus(3) As MenuItem
    ' Create three menu items to add to the submenu item array.
    Dim subMenuItem1 As New MenuItem("Red")
    Dim subMenuItem2 As New MenuItem("Blue")
    Dim subMenuItem3 As New MenuItem("Green")
    ' Add the submenu items to the array.
    subMenus(0) = subMenuItem1
    subMenus(1) = subMenuItem2
    subMenus(2) = subMenuItem3
    ' Create an instance of a MenuItem with caption and an array of submenu
    ' items specified.
    Dim MenuItem1 As New MenuItem("&Colors", subMenus)
End Sub

Keterangan

Saat menentukan caption untuk item menu dengan text parameter , Anda juga dapat menentukan kunci akses dengan menempatkan '&' sebelum karakter digunakan sebagai kunci akses. Misalnya, untuk menentukan "F" dalam "File" sebagai kunci akses, Anda akan menentukan caption untuk item menu sebagai "file &". Anda dapat menggunakan fitur ini untuk menyediakan navigasi keyboard untuk menu Anda.

text Mengatur parameter ke "-" menyebabkan item menu Anda ditampilkan sebagai pemisah (garis horizontal) daripada item menu standar.

Parameter items memungkinkan Anda menetapkan array item menu untuk menentukan submenu item menu ini. Setiap item dalam array juga dapat memiliki array item menu yang ditetapkan untuknya. Ini memungkinkan Anda membuat struktur menu lengkap dan menetapkannya ke konstruktor untuk item menu.

Untuk informasi selengkapnya tentang penanganan peristiwa, lihat Menangani dan Menaikkan Peristiwa.

MenuItem(String, EventHandler, Shortcut)

Menginisialisasi instans baru kelas dengan caption tertentu, penanganan aktivitas, dan kunci pintasan terkait untuk item menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick, System::Windows::Forms::Shortcut shortcut);

public MenuItem (string text, EventHandler onClick, System.Windows.Forms.Shortcut shortcut);

new System.Windows.Forms.MenuItem : string * EventHandler * System.Windows.Forms.Shortcut -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler, shortcut As Shortcut)

Parameter

text

String

Caption untuk item menu.

onClick

EventHandler

yang EventHandler menangani Click kejadian untuk item menu ini.

shortcut

Shortcut

Salah Shortcut satu nilai.

Contoh

Contoh kode berikut membuat objek dengan caption tertentu, kunci pintasan, dan penanganan aktivitas yang tersambung ke metode yang akan menangani peristiwa untuk item menu.

public:
   void CreateMyMenuItem()
   {
      // Create a MenuItem with caption, shortcut key, and an event handler
      // specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&New",
         gcnew System::EventHandler( this, &Form1::MenuItem1_Click ), Shortcut::CtrlL );
   }

private:
   // The following method is an event handler for menuItem1 to use when
   // connecting the event handler.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create a MenuItem with caption, shortcut key, and an event handler
   // specified.
   MenuItem MenuItem1 = new MenuItem("&New",
       new System.EventHandler(this.MenuItem1_Click), Shortcut.CtrlL);
}

// The following method is an event handler for menuItem1 to use when
// connecting the event handler.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create a MenuItem with caption, shortcut key, and an event handler
    ' specified.
    Dim MenuItem1 As New MenuItem("&New", _
       New System.EventHandler(AddressOf Me.MenuItem1_Click), Shortcut.CtrlL)
End Sub    
   
' The following method is an event handler for menuItem1 to use when
' connecting the event handler.
Private Sub MenuItem1_Click(sender As Object, e As EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Keterangan

Saat menentukan caption untuk item menu dengan text parameter , Anda juga dapat menentukan kunci akses dengan menempatkan '&' sebelum karakter digunakan sebagai kunci akses. Misalnya, untuk menentukan "F" dalam "File" sebagai kunci akses, Anda akan menentukan caption untuk item menu sebagai "file &". Anda dapat menggunakan fitur ini untuk menyediakan navigasi keyboard untuk menu Anda. Konstruktor ini juga memungkinkan Anda menentukan tombol pintasan selain tombol akses untuk menyediakan navigasi keyboard. Tombol pintasan memungkinkan Anda menentukan kombinasi tombol yang dapat digunakan untuk mengaktifkan item menu.

text Mengatur parameter ke "-" menyebabkan item menu Anda ditampilkan sebagai pemisah (garis horizontal) daripada item menu standar.

Selain itu, Anda dapat menggunakan konstruktor ini untuk menentukan delegasi yang akan menangani Click peristiwa untuk item menu yang sedang dibuat. EventHandler yang Anda berikan ke konstruktor ini harus dikonfigurasi untuk memanggil penanganan aktivitas yang dapat menangani Click peristiwa. Untuk informasi selengkapnya tentang penanganan peristiwa, lihat Menangani dan Menaikkan Peristiwa.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Menginisialisasi instans MenuItem baru kelas dengan caption tertentu; penanganan aktivitas yang ditentukan untuk Click, Select dan Popup peristiwa; kunci pintasan; jenis penggabungan; dan urutan yang ditentukan untuk item menu.

public:
 MenuItem(System::Windows::Forms::MenuMerge mergeType, int mergeOrder, System::Windows::Forms::Shortcut shortcut, System::String ^ text, EventHandler ^ onClick, EventHandler ^ onPopup, EventHandler ^ onSelect, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (System.Windows.Forms.MenuMerge mergeType, int mergeOrder, System.Windows.Forms.Shortcut shortcut, string text, EventHandler onClick, EventHandler onPopup, EventHandler onSelect, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : System.Windows.Forms.MenuMerge * int * System.Windows.Forms.Shortcut * string * EventHandler * EventHandler * EventHandler * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (mergeType As MenuMerge, mergeOrder As Integer, shortcut As Shortcut, text As String, onClick As EventHandler, onPopup As EventHandler, onSelect As EventHandler, items As MenuItem())

Parameter

mergeType

MenuMerge

Salah MenuMerge satu nilai.

mergeOrder

Int32

Posisi relatif yang akan diambil item menu ini dalam menu gabungan.

shortcut

Shortcut

Salah Shortcut satu nilai.

text

String

Caption untuk item menu.

onClick

EventHandler

yang EventHandler menangani Click kejadian untuk item menu ini.

onPopup

EventHandler

yang EventHandler menangani Popup kejadian untuk item menu ini.

onSelect

EventHandler

yang EventHandler menangani Select kejadian untuk item menu ini.

items

MenuItem[]

Array MenuItem objek yang berisi item submenu untuk item menu ini.

Contoh

Contoh kode berikut membuat item menu yang memiliki caption dan kunci pintasan. Item menu juga memiliki penanganan aktivitas yang ditentukan untuk Popupperistiwa , , Clickdan Select . Jika item menu ini digabungkan, item menu akan ditambahkan ke menu dengan urutan penggabungan nol.

public:
   void CreateMyMenuItem()
   {
      // Submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      /* Create a MenuItem with caption, shortcut key, 
         a Click, Popup, and Select event handler, merge type and order, and an 
         array of submenu items specified.
      */
      MenuItem^ menuItem1 = gcnew MenuItem( MenuMerge::Add, 0,
         Shortcut::CtrlShiftC, "&Colors",
         gcnew EventHandler( this, &Form1::MenuItem1_Click ),
         gcnew EventHandler( this, &Form1::MenuItem1_Popup ),
         gcnew EventHandler( this, &Form1::MenuItem1_Select ), subMenus );
   }

private:
   // The following method is an event handler for menuItem1 to use when connecting the Click event.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Popup event.
   void MenuItem1_Popup( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Select event
   void MenuItem1_Select( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");

   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   /* Create a MenuItem with caption, shortcut key, 
      a Click, Popup, and Select event handler, merge type and order, and an 
      array of submenu items specified.
   */
   MenuItem menuItem1 = new MenuItem(MenuMerge.Add, 0,
      Shortcut.CtrlShiftC, "&Colors", 
      new EventHandler(this.MenuItem1_Click),
      new EventHandler(this.MenuItem1_Popup),
      new EventHandler(this.MenuItem1_Select), subMenus);
}

// The following method is an event handler for menuItem1 to use when connecting the Click event.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Popup event.
private void MenuItem1_Popup(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Select event
private void MenuItem1_Select(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
   ' Submenu item array.
   Dim SubMenus(3) as MenuItem
   ' Create three menu items to add to the submenu item array.
   Dim SubMenuItem1, SubMenuItem2, SubMenuItem3 as MenuItem
   SubMenuItem1 = New MenuItem ("Red")
   SubMenuItem2 = New MenuItem ("Blue")
   SubMenuItem3 = New MenuItem ("Green")
   ' Add the submenu items to the array.
   SubMenus(0) = SubMenuItem1
   SubMenus(1) = SubMenuItem2
   SubMenus(2) = SubMenuItem3
   ' Create a MenuItem with caption, shortcut key, 
   ' a Click, Popup, and Select event handler, menu merge type and order, and an 
   ' array of submenu items specified.
   Dim MenuItem1 As MenuItem
   MenuItem1 = New MenuItem(MenuMerge.Add, 0, Shortcut.CtrlShiftC, "&Colors", _
      AddressOf Me.MenuItem1_Click, _
      AddressOf Me.MenuItem1_Popup, _
      AddressOf Me.MenuItem1_Select, SubMenus)
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Click event.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Popup event.
Private Sub MenuItem1_Popup(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Select event
Private Sub MenuItem1_Select(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

Keterangan

Saat menentukan caption untuk item menu dengan text parameter , Anda juga dapat menentukan kunci akses dengan menempatkan '&' sebelum karakter digunakan sebagai kunci akses. Misalnya, untuk menentukan "F" dalam "File" sebagai kunci akses, Anda akan menentukan caption untuk item menu sebagai "file &". Anda dapat menggunakan fitur ini untuk menyediakan navigasi keyboard untuk menu Anda.

text Mengatur parameter ke "-" menyebabkan item menu Anda ditampilkan sebagai pemisah (garis horizontal) daripada item menu standar.

Parameter items memungkinkan Anda menetapkan array item menu untuk menentukan submenu item menu ini. Setiap item dalam array juga dapat memiliki array item menu yang ditetapkan untuknya. Ini memungkinkan Anda membuat struktur menu lengkap dan menetapkannya ke konstruktor untuk item menu.

Parameter mergeType dan mergeOrder memungkinkan Anda menentukan bagaimana item menu ini akan berkinerja ketika item menu digabungkan dengan menu lain. Bergantung pada nilai yang Anda tentukan untuk mergeType parameter, Anda dapat menambahkan, menghapus, mengganti, atau menggabungkan item menu dan item submenunya dengan menu yang digabungkan. Parameter mergeOrder menentukan di mana item menu yang dibuat akan diposisikan saat menu digabungkan.

Selain itu, Anda dapat menggunakan konstruktor ini untuk membuat MenuItem dan menyambungkannya ke penanganan aktivitas dalam kode Anda yang akan memproses klik item menu. EventHandler yang Anda lewati ke konstruktor ini harus dikonfigurasi untuk memanggil penanganan aktivitas yang dapat menangani Click peristiwa. Dengan menggunakan versi konstruktor ini, Anda juga dapat menyambungkan Popup peristiwa dan Select untuk menentukan kapan item menu ini dipilih. Anda dapat menggunakan peristiwa ini untuk tugas-tugas seperti menentukan apakah akan menampilkan tanda centang di samping item submenu atau untuk mengaktifkan atau menonaktifkan item menu berdasarkan status aplikasi. Peristiwa Select dan Click dimunculkan hanya untuk MenuItem objek yang bukan item menu induk. Untuk informasi selengkapnya tentang penanganan peristiwa, lihat Menangani dan Menaikkan Peristiwa.

Lihat juga

• Popup
• Select
• Click
• MergeType
• MergeOrder