Menu Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Menu.cs

Dikkat

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.

Tüm menüler için temel işlevselliği temsil eder.

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine, denetimi değiştiren ve genişleten Menu ve ToolStripDropDownMenu kullanınToolStripDropDown.

public ref class Menu abstract : 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)>]
[<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

Devralma

Object

MarshalByRefObject

Component

Menu

Türetilmiş

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Öznitelikler

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, MenuItemform için bir menü yapısı oluşturmak üzere türetilmiş sınıfını kullanır. Örnek kod, en üst düzey menü öğesini göstermek için bir MenuItem ekler, yazı tipi boyutu seçmek için bu öğeye bir alt menü öğesi ekler ve sonra bu menü öğesine bir uygulamadaki büyük ve küçük yazı tipi seçimlerini temsil eden iki alt menü öğesi ekler. Örnek, adlı bir MainMenu nesnenin ve , menuItem2, menuItem3ve menuItem4adlı menuItem1dört MenuItem nesnenin olmasını mainMenu1 gerektirir.

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

Açıklamalar

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine ToolStripDropDown ve ToolStripDropDownMenu kullanın.

Bu sınıf, , MainMenuve MenuItem sınıfları için ContextMenutemel sınıftır. Bu sınıfın bir örneğini oluşturamazsınız. Bir uygulamanın menüleri nesnelerden MenuItem oluşur. Bunlar, alt menü öğelerini temsil eden başka MenuItem nesneler içerebilir. Nesneler MenuItem , formda MainMenu veya ContextMenu kısayol menülerini görüntülemek için kullanılan bir menü yapısının tamamı olarak görüntüleme için içinde depolanabilir. Bu sınıf, tüm menü sınıfları için ortak olan işlevler sağlar.

Birçok temel sınıftan Menu farklı olarak, sınıfı birçok özelliğini tanımlamak için türetilmiş sınıflarını kullanır. Menünüzü birden çok belgeli arabirim (MDI) uygulamasında kullanıyorsanız, özelliği kullanarak uygulamanızda açık MDI alt formlarının listesini görüntüleyen bir MenuItem belirtebilirsinizMdiListItem. özelliği, MenuItems menü sınıfında depolanan nesnelerin listesini MenuItem içerir. MainMenu veya ContextMenuiçin, bu özellik görüntülenen tüm MenuItem nesneleri içerir. için MenuItemözelliği, MenuItems kendisiyle ilişkilendirilmiş alt menü öğelerini temsil eder.

Sınıf, tüm türetilmiş menü sınıfları için sağlanan özelliklere ek olarak, Menu mevcut menülerden yeni menüler oluşturmanıza ve iki menü yapısını birleştirmenize olanak tanıyan ve MergeMenugibi CloneMenu yöntemler de sağlar.

sınıfı, Menu iç içe geçmiş sınıfını Menu.MenuItemCollectionda tanımlar. Bu sınıf özelliği tarafından MenuItems kullanılan nesne koleksiyonunu MenuItem tanımlar. , veya MenuItemmenü öğelerini ContextMenuMainMenueklemek ve kaldırmak için sınıfının yöntemlerini Menu.MenuItemCollection kullanabilirsiniz.

Oluşturucular

Name	Description
Menu(MenuItem[])	Geçersiz. Menu sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
FindHandle	Geçersiz. yönteminin FindMenuItem(Int32, IntPtr) bir tanıtıcı araması gerektiğini belirtir.
FindShortcut	Geçersiz. yönteminin FindMenuItem(Int32, IntPtr) bir kısayol araması gerektiğini belirtir.

Özellikler

Name	Description
Handle	Geçersiz. Menünün pencere tutamacını temsil eden bir değer alır.
IsParent	Geçersiz. Bu menünün herhangi bir menü öğesi içerip içermediğini belirten bir değer alır. Bu özellik salt okunurdur.
MdiListItem	Geçersiz. Birden çok belge arabirimi (MDI) alt formu listesini görüntülemek için kullanılan değerini belirten MenuItem bir değer alır.
MenuItems	Geçersiz. Menüyle ilişkili nesne koleksiyonunu MenuItem gösteren bir değer alır.
Name	Geçersiz. öğesinin adını Menualır veya ayarlar.
Tag	Geçersiz. Denetimle ilişkili kullanıcı tanımlı verileri alır veya ayarlar.

Yöntemler

Name	Description
CloneMenu(Menu)	Geçersiz. Menu Parametresi olarak geçirilen öğesini geçerli Menuöğesine kopyalar.
CreateMenuHandle()	Geçersiz. için Menuyeni bir tanıtıcı oluşturur.
FindMenuItem(Int32, IntPtr)	Geçersiz. MenuItem Belirtilen değeri içeren değerini alır.
FindMergePosition(Int32)	Geçersiz. Menü öğesinin menüye eklenmesi gereken konumu döndürür.
GetContextMenu()	Geçersiz. Bu menüyü ContextMenu içeren öğesini alır.
GetMainMenu()	Geçersiz. Bu menüyü MainMenu içeren öğesini alır.
MergeMenu(Menu)	Geçersiz. Bir menünün MenuItem nesnelerini geçerli menüyle birleştirir.
ProcessCmdKey(Message, Keys)	Geçersiz. Bir komut anahtarını işler.

Ayrıca bkz.

• MainMenu
• ContextMenu
• MenuItem