Menu Kelas

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Sumber:: Menu.cs

Sumber:: Menu.cs

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.

Perhatian

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

Mewakili fungsionalitas dasar untuk semua menu.

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ToolStripDropDown dan ToolStripDropDownMenu sebagai gantinya Menu , yang menggantikan dan memperluas kontrol.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Warisan: Object

MarshalByRefObject

Component
Menu

Turunan: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Atribut: ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Contoh

Contoh kode berikut menggunakan kelas turunan, MenuItem, untuk 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 ToolStripDropDown dan ToolStripDropDownMenu sebagai gantinya.

Kelas ini adalah kelas dasar untuk MainMenukelas , , MenuItemdan ContextMenu . Anda tidak dapat membuat instans kelas ini. Menu untuk aplikasi terdiri dari MenuItem objek. Ini dapat berisi objek lain MenuItem , yang mewakili item submenu. Objek MenuItem dapat disimpan dalam MainMenu tampilan sebagai seluruh struktur menu untuk formulir atau ContextMenu yang digunakan untuk menampilkan menu pintasan. Kelas ini menyediakan fungsionalitas yang umum untuk semua kelas menu.

Tidak seperti banyak kelas dasar, Menu kelas menggunakan kelas turunannya untuk menentukan banyak propertinya. Jika Anda menggunakan menu dalam aplikasi antarmuka beberapa dokumen (MDI), Anda dapat menggunakan MdiListItem properti untuk menentukan MenuItem yang menampilkan daftar formulir anak MDI terbuka di aplikasi Anda. Properti MenuItems berisi daftar MenuItem objek yang disimpan di kelas menu. MainMenu Untuk atau ContextMenu, properti ini berisi semua MenuItem objek yang ditampilkan. MenuItemUntuk , MenuItems properti mewakili item submenu yang terkait dengannya.

Selain properti yang disediakan untuk semua kelas menu turunan, Menu kelas ini juga menyediakan metode, seperti CloneMenu dan MergeMenu, yang memungkinkan Anda membuat menu baru dari menu yang ada, dan juga menggabungkan dua struktur menu bersama-sama.

Kelas juga Menu mendefinisikan kelas Menu.MenuItemCollectionberlapis . Kelas ini mendefinisikan kumpulan MenuItem objek yang digunakan oleh MenuItems properti . Anda dapat menggunakan metode Menu.MenuItemCollection kelas untuk menambahkan dan menghapus item menu dari MainMenu, , ContextMenuatau MenuItem.

Konstruktor

Nama	Deskripsi
Menu(MenuItem[])	Kedaluwarsa. Menginisialisasi instans baru dari kelas Menu.

Bidang

Nama	Deskripsi
FindHandle	Kedaluwarsa. Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari handel.
FindShortcut	Kedaluwarsa. Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari pintasan.

Properti

Nama	Deskripsi
CanRaiseEvents	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	Kedaluwarsa. IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DesignMode	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Kedaluwarsa. Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Handle	Kedaluwarsa. Mendapatkan nilai yang mewakili handel jendela untuk menu.
IsParent	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah menu ini berisi item menu apa pun. Properti ini hanya dapat dibaca.
MdiListItem	Kedaluwarsa. Mendapatkan nilai yang menunjukkan MenuItem yang digunakan untuk menampilkan daftar beberapa formulir anak antarmuka dokumen (MDI).
MenuItems	Kedaluwarsa. Mendapatkan nilai yang menunjukkan kumpulan MenuItem objek yang terkait dengan menu.
Name	Kedaluwarsa. Mendapatkan atau menetapkan nama Menu.
Site	Kedaluwarsa. Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Tag	Kedaluwarsa. Mendapatkan atau mengatur data yang ditentukan pengguna yang terkait dengan kontrol.

Metode

Nama	Deskripsi
CloneMenu(Menu)	Kedaluwarsa. Menu Menyalin yang diteruskan sebagai parameter ke saat ini Menu.
CreateMenuHandle()	Kedaluwarsa. Membuat handel baru ke Menu.
CreateObjRef(Type)	Kedaluwarsa. Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Kedaluwarsa. Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Kedaluwarsa. Membuang sumber daya, selain memori, yang digunakan oleh Menu.
Equals(Object)	Kedaluwarsa. Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindMenuItem(Int32, IntPtr)	Kedaluwarsa. MenuItem Mendapatkan yang berisi nilai yang ditentukan.
FindMergePosition(Int32)	Kedaluwarsa. Mengembalikan posisi di mana item menu harus disisipkan ke dalam menu.
GetContextMenu()	Kedaluwarsa. ContextMenu Mendapatkan yang berisi menu ini.
GetHashCode()	Kedaluwarsa. 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()	Kedaluwarsa. MainMenu Mendapatkan yang berisi menu ini.
GetService(Type)	Kedaluwarsa. Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Kedaluwarsa. Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Kedaluwarsa. Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Kedaluwarsa. Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
MergeMenu(Menu)	Kedaluwarsa. MenuItem Menggabungkan objek dari satu menu dengan menu saat ini.
ProcessCmdKey(Message, Keys)	Kedaluwarsa. Memproses kunci perintah.
ToString()	Kedaluwarsa. Mengembalikan yang String mewakili Menu kontrol.

Acara

Nama	Deskripsi
Disposed	Kedaluwarsa. Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?