Menu Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

Menu

Afgeleid

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Kenmerken

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Voorbeelden

In het volgende codevoorbeeld wordt de afgeleide klasse MenuItemgebruikt om een menustructuur voor een formulier te maken. De voorbeeldcode voegt een MenuItem item toe om het menu-item op het hoogste niveau weer te geven, voegt er een submenu-item aan toe voor het selecteren van een tekengrootte en voegt vervolgens twee submenu-items toe aan dat menu-item dat grote en kleine lettertypekeuzen in een toepassing vertegenwoordigt. Het voorbeeld vereist dat er een object met de MainMenu naam en vier mainMenu1 objecten met de naam MenuItem, menuItem1en menuItem2menuItem3.menuItem4

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

Opmerkingen

Deze klasse is niet beschikbaar in .NET Core 3.1 en nieuwere versies. Gebruik ToolStripDropDown en ToolStripDropDownMenu in plaats daarvan.

Deze klasse is de basisklasse voor de MainMenu, MenuItemen ContextMenu klassen. U kunt geen exemplaar van deze klasse maken. De menu's voor een toepassing bestaan uit MenuItem objecten. Deze kunnen andere MenuItem objecten bevatten, die submenu-items vertegenwoordigen. De MenuItem objecten kunnen worden opgeslagen in een MainMenu weergave als een volledige menustructuur voor een formulier of een ContextMenu formulier dat wordt gebruikt om snelmenu's weer te geven. Deze klasse biedt functionaliteit die gebruikelijk is voor alle menuklassen.

In tegenstelling tot veel basisklassen gebruikt de Menu klasse de afgeleide klassen om veel eigenschappen te definiëren. Als u uw menu gebruikt in een MDI-toepassing (Multiple Document Interface), kunt u de MdiListItem eigenschap gebruiken om een MenuItem lijst met geopende MDI-onderliggende formulieren in uw toepassing weer te geven. De MenuItems eigenschap bevat een lijst MenuItem met objecten die zijn opgeslagen in de menuklasse. Voor een MainMenu of ContextMenubevat deze eigenschap alle MenuItem objecten die worden weergegeven. Voor een MenuItem, de MenuItems eigenschap vertegenwoordigt de submenu-items die eraan zijn gekoppeld.

Naast de eigenschappen die zijn opgegeven voor alle afgeleide menuklassen, biedt de Menu klasse ook methoden, zoals CloneMenu en MergeMenu, waarmee u nieuwe menu's kunt maken op basis van bestaande menu's en ook twee menustructuren samenvoegt.

De Menu klasse definieert ook de geneste klasse Menu.MenuItemCollection. Deze klasse definieert de verzameling objecten die MenuItem door de MenuItems eigenschap worden gebruikt. U kunt de methoden van de Menu.MenuItemCollection klasse gebruiken om menu-items toe te voegen aan en te verwijderen uit een MainMenu, ContextMenuof MenuItem.

Zie ook

• MainMenu
• ContextMenu
• MenuItem