MenuItem Kelas

Referensi

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.

Mewakili item individual yang ditampilkan dalam MainMenu atau ContextMenu.

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ToolStripMenuItem sebagai gantinya, yang menggantikan MenuItem kontrol.

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Warisan: Object

MarshalByRefObject

Component

Menu
MenuItem

Contoh

Contoh kode berikut membuat struktur menu untuk formulir. Kode contoh menambahkan MenuItem untuk mewakili item menu tingkat atas, menambahkan item submenu ke dalamnya untuk memilih ukuran font, lalu menambahkan dua item submenu ke item menu yang mewakili pilihan font besar dan kecil dalam aplikasi. Contohnya mengharuskan ada objek bernama mainMenu1 dan empat MenuItem objek bernama menuItem1, , menuItem2menuItem3, dan menuItem4.MainMenu

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Keterangan

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ToolStripMenuItem sebagai gantinya.

Agar ditampilkan MenuItem , Anda harus menambahkannya ke MainMenu atau ContextMenu. Untuk membuat submenu, Anda dapat menambahkan MenuItem objek ke MenuItems properti induk MenuItem.

Kelas menyediakan MenuItem properti yang memungkinkan Anda mengonfigurasi tampilan dan fungsionalitas item menu. Untuk menampilkan tanda centang di samping item menu, gunakan Checked properti . Anda dapat menggunakan fitur ini untuk mengidentifikasi item menu yang dipilih dalam daftar item menu yang saling eksklusif. Misalnya, jika Anda memiliki sekumpulan item menu untuk mengatur warna teks dalam TextBox kontrol, Anda dapat menggunakan Checked properti untuk mengidentifikasi warna mana yang saat ini dipilih. Properti Shortcut dapat digunakan untuk menentukan kombinasi keyboard yang dapat ditekan untuk memilih item menu.

Untuk MenuItem objek yang ditampilkan dalam aplikasi Antarmuka Beberapa Dokumen (MDI), Anda dapat menggunakan MergeMenu metode untuk menggabungkan menu induk MDI dengan formulir turunannya untuk membuat struktur menu terkonsolidasi. MenuItem Karena tidak dapat digunakan kembali di beberapa lokasi pada saat yang sama, seperti di dan ContextMenu MainMenu , Anda dapat menggunakan CloneMenu metode untuk membuat salinan MenuItem untuk digunakan di lokasi lain.

Kejadian ini Popup memungkinkan Anda melakukan tugas sebelum menu ditampilkan. Misalnya, Anda dapat membuat penanganan aktivitas untuk kejadian ini untuk menampilkan atau menyembunyikan item menu berdasarkan status kode Anda. Kejadian ini Select memungkinkan Anda melakukan tugas seperti memberikan bantuan terperinci untuk item menu aplikasi Anda saat pengguna menempatkan penunjuk mouse di atas item menu.

Konstruktor

MenuItem()	Menginisialisasi MenuItem dengan caption kosong.
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(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, EventHandler, Shortcut)	Menginisialisasi instans baru kelas dengan caption tertentu, penanganan aktivitas, dan kunci pintasan terkait untuk item menu.
MenuItem(String, MenuItem[])	Menginisialisasi instans baru kelas dengan caption tertentu dan array item submenu yang ditentukan untuk item menu.

Bidang

FindHandle	Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari handel. (Diperoleh dari Menu)
FindShortcut	Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari pintasan. (Diperoleh dari Menu)

Properti

BarBreak	Mendapatkan atau mengatur nilai yang menunjukkan apakah MenuItem ditempatkan pada baris baru (untuk item menu yang ditambahkan ke MainMenu objek) atau di kolom baru (untuk item submenu atau item menu yang ditampilkan dalam ContextMenu).
Break	Mendapatkan atau mengatur nilai yang menunjukkan apakah item ditempatkan pada baris baru (untuk item menu yang ditambahkan ke MainMenu objek) atau di kolom baru (untuk item menu atau item submenu yang ditampilkan dalam ContextMenu).
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Checked	Mendapatkan atau mengatur nilai yang menunjukkan apakah tanda centang muncul di samping teks item menu.
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DefaultItem	Mendapatkan atau mengatur nilai yang menunjukkan apakah item menu adalah item menu default.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Enabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah item menu diaktifkan.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Handle	Mendapatkan nilai yang mewakili handel jendela untuk menu. (Diperoleh dari Menu)
Index	Mendapatkan atau menetapkan nilai yang menunjukkan posisi item menu di menu induknya.
IsParent	Mendapatkan nilai yang menunjukkan apakah item menu berisi item menu turunan.
MdiList	Mendapatkan atau mengatur nilai yang menunjukkan apakah item menu akan diisi dengan daftar jendela anak Multi-Antarmuka Dokumen (MDI) yang ditampilkan dalam formulir terkait.
MdiListItem	Mendapatkan nilai yang menunjukkan MenuItem yang digunakan untuk menampilkan daftar beberapa formulir anak antarmuka dokumen (MDI). (Diperoleh dari Menu)
MenuID	Mendapatkan nilai yang menunjukkan pengidentifikasi Windows untuk item menu ini.
MenuItems	Mendapatkan nilai yang menunjukkan kumpulan MenuItem objek yang terkait dengan menu. (Diperoleh dari Menu)
MergeOrder	Mendapatkan atau mengatur nilai yang menunjukkan posisi relatif item menu saat digabungkan dengan yang lain.
MergeType	Mendapatkan atau mengatur nilai yang menunjukkan perilaku item menu ini ketika menunya digabungkan dengan yang lain.
Mnemonic	Mendapatkan nilai yang menunjukkan karakter mnemonic yang terkait dengan item menu ini.
Name	Mendapatkan atau mengatur nama Menu. (Diperoleh dari Menu)
OwnerDraw	Mendapatkan atau mengatur nilai yang menunjukkan apakah kode yang Anda sediakan menggambar item menu atau Windows menggambar item menu.
Parent	Mendapatkan nilai yang menunjukkan menu yang berisi item menu ini.
RadioCheck	Mendapatkan atau mengatur nilai yang menunjukkan apakah MenuItem, jika dicentang, menampilkan tombol radio alih-alih tanda centang.
Shortcut	Mendapatkan atau mengatur nilai yang menunjukkan kunci pintasan yang terkait dengan item menu.
ShowShortcut	Mendapatkan atau mengatur nilai yang menunjukkan apakah kunci pintasan yang terkait dengan item menu ditampilkan di samping item menu caption.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Tag	Mendapatkan atau mengatur data yang ditentukan pengguna yang terkait dengan kontrol. (Diperoleh dari Menu)
Text	Mendapatkan atau menetapkan nilai yang menunjukkan caption item menu.
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah item menu terlihat.

Metode

CloneMenu()	Membuat salinan dari saat ini MenuItem.
CloneMenu(Menu)	Menu Menyalin yang diteruskan sebagai parameter ke saat ini Menu. (Diperoleh dari Menu)
CloneMenu(MenuItem)	Membuat salinan dari yang ditentukan MenuItem.
CreateMenuHandle()	Membuat handel baru ke Menu. (Diperoleh dari Menu)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Membuang sumber daya (selain memori) yang digunakan oleh MenuItem.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindMenuItem(Int32, IntPtr)	MenuItem Mendapatkan yang berisi nilai yang ditentukan. (Diperoleh dari Menu)
FindMergePosition(Int32)	Mengembalikan posisi di mana item menu harus disisipkan ke dalam menu. (Diperoleh dari Menu)
GetContextMenu()	Mendapatkan yang ContextMenu berisi menu ini. (Diperoleh dari Menu)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetMainMenu()	Mendapatkan yang MainMenu berisi menu ini. (Diperoleh dari Menu)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
MergeMenu()	Menggabungkan ini MenuItem dengan yang lain MenuItem dan mengembalikan gabungan MenuItemyang dihasilkan.
MergeMenu(Menu)	MenuItem Menggabungkan objek dari satu menu dengan menu saat ini. (Diperoleh dari Menu)
MergeMenu(MenuItem)	Menggabungkan item menu lain dengan item menu ini.
OnClick(EventArgs)	Memunculkan kejadian Click.
OnDrawItem(DrawItemEventArgs)	Memunculkan kejadian DrawItem.
OnInitMenuPopup(EventArgs)	Memunculkan kejadian Popup.
OnMeasureItem(MeasureItemEventArgs)	Memunculkan kejadian MeasureItem.
OnPopup(EventArgs)	Memunculkan kejadian Popup.
OnSelect(EventArgs)	Memunculkan kejadian Select.
PerformClick()	Click Menghasilkan peristiwa untuk MenuItem, mensimulasikan klik oleh pengguna.
PerformSelect()	Menaikkan Select kejadian untuk item menu ini.
ProcessCmdKey(Message, Keys)	Memproses kunci perintah. (Diperoleh dari Menu)
ToString()	Mengembalikan string yang mewakili MenuItem.

Acara

Click	Terjadi ketika item menu diklik atau dipilih menggunakan kunci pintasan atau kunci akses yang ditentukan untuk item menu.
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
DrawItem	Terjadi ketika OwnerDraw properti item menu diatur ke `true` dan permintaan dibuat untuk menggambar item menu.
MeasureItem	Terjadi ketika menu perlu mengetahui ukuran item menu sebelum menggambarnya.
Popup	Terjadi sebelum daftar item menu item menu ditampilkan.
Select	Terjadi ketika pengguna menempatkan penunjuk di atas item menu.

Berlaku untuk

Share via