Menu Klass

Definition

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

Arv

Object

MarshalByRefObject

Component

Menu

Härledda

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Attribut

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Exempel

I följande kodexempel används den härledda klassen , MenuItemför att skapa en menystruktur för ett formulär. Exempelkoden lägger till en MenuItem för att representera menyalternativet på den översta nivån, lägger till ett undermenyobjekt till det för att välja en teckenstorlek och lägger sedan till två undermenyobjekt i menyalternativet som representerar stora och små teckensnittsalternativ i ett program. Exemplet kräver att det finns ett MainMenu objekt med namnet mainMenu1 och fyra MenuItem objekt med namnet menuItem1, menuItem2, menuItem3och 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

Kommentarer

Den här klassen är inte tillgänglig i .NET Core 3.1 och senare versioner. Använd ToolStripDropDown och ToolStripDropDownMenu i stället.

Den här klassen är basklassen för klasserna MainMenu, MenuItemoch ContextMenu . Du kan inte skapa en instans av den här klassen. Menyerna för ett program består av MenuItem objekt. Dessa kan innehålla andra MenuItem objekt som representerar undermenyobjekt. Objekten MenuItem kan lagras i en MainMenu för visning som en hel menystruktur för ett formulär eller en ContextMenu som används för att visa snabbmenyer. Den här klassen innehåller funktioner som är vanliga för alla menyklasser.

Till skillnad från många basklasser Menu använder klassen sina härledda klasser för att definiera många av dess egenskaper. Om du använder din meny i ett MDI-program (multiple-document interface) kan du använda MdiListItem egenskapen för att ange en MenuItem som visar en lista över öppna MDI-underordnade formulär i ditt program. Egenskapen MenuItems innehåller en lista över MenuItem objekt som lagras i menyklassen. För en MainMenu eller ContextMenuinnehåller den här egenskapen alla MenuItem objekt som visas. För en MenuItemrepresenterar egenskapen MenuItems de undermenyobjekt som är associerade med den.

Förutom de egenskaper som tillhandahålls för alla härledda menyklasser Menu tillhandahåller klassen även metoder, till exempel och CloneMenu, som MergeMenu gör att du kan skapa nya menyer från befintliga menyer och även sammanfoga två menystrukturer.

Klassen Menu definierar också den kapslade klassen Menu.MenuItemCollection. Den här klassen definierar samlingen med MenuItem objekt som används av egenskapen MenuItems . Du kan använda klassmetoderna Menu.MenuItemCollection för att lägga till och ta bort menyalternativ från en MainMenu, ContextMenueller MenuItem.

Se även

• MainMenu
• ContextMenu
• MenuItem