Sdílet prostřednictvím

Menu Třída

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll
Zdroj:
Menu.cs
Zdroj:
Menu.cs

Upozornění

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.

Představuje základní funkci pro všechny nabídky.

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Použijte ToolStripDropDown a ToolStripDropDownMenu místo toho nahraďte a rozšiřte Menu ovládací prvek.

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
Dědičnost
Object
MarshalByRefObject
Component
Menu
Odvozené
Atributy
ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Příklady

Následující příklad kódu používá odvozenou třídu , MenuItemvytvořit strukturu nabídky pro formulář. Ukázkový kód přidá MenuItem položku nabídky nejvyšší úrovně, přidá do ní položku podnabídky pro výběr velikosti písma a pak do ní přidá dvě podnabídky, které představují velké a malé volby písma v aplikaci. Příklad vyžaduje, aby objekt s MainMenu názvem a čtyři MenuItem objekty s názvem menuItem1, menuItem2, menuItem3a menuItem4mainMenu1 .

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

Poznámky

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Použijte ToolStripDropDown a ToolStripDropDownMenu místo toho.

Tato třída je základní třídou pro MainMenu, MenuItema ContextMenu třídy. Nelze vytvořit instanci této třídy. Nabídky aplikace se skládají z MenuItem objektů. Mohou obsahovat další MenuItem objekty, které představují podnabídky. Objekty MenuItem lze uložit do MainMenu zobrazení jako celou strukturu nabídek formuláře nebo objektu ContextMenu , který se používá k zobrazení místních nabídek. Tato třída poskytuje funkce, které jsou společné pro všechny třídy nabídek.

Na rozdíl od mnoha základních tříd třída Menu používá své odvozené třídy k definování mnoha svých vlastností. Pokud používáte nabídku v aplikaci MDI (multiple-document interface), můžete pomocí MdiListItem vlastnosti určit MenuItem , která zobrazí seznam otevřených podřízených formulářů MDI ve vaší aplikaci. Vlastnost MenuItems obsahuje seznam objektů uložených MenuItem ve třídě nabídky. MainMenu Pro nebo ContextMenu, tato vlastnost obsahuje všechny MenuItem objekty, které jsou zobrazeny. Pro vlastnost MenuItemMenuItems představuje podnabídky přidružené k němu.

Kromě vlastností, které jsou k dispozici pro všechny odvozené třídy nabídky, Menu třída také poskytuje metody, jako CloneMenuMergeMenua , které umožňují vytvářet nové nabídky z existujících nabídek a také sloučit dvě struktury nabídek dohromady.

Třída Menu také definuje vnořenou třídu Menu.MenuItemCollection. Tato třída definuje kolekci MenuItem objektů používaných vlastností MenuItems . Pomocí metod Menu.MenuItemCollection třídy můžete přidávat a odebírat položky nabídky z objektu MainMenu, ContextMenunebo MenuItem.

Konstruktory

Name Description
Menu(MenuItem[])
Zastaralé.

Inicializuje novou instanci Menu třídy.

Pole

Name Description
FindHandle
Zastaralé.

Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla hledat popisovač.
FindShortcut
Zastaralé.

Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla vyhledat zástupce.

Vlastnosti

Name Description
CanRaiseEvents
Zastaralé.

Získá hodnotu určující, zda komponenta může vyvolat událost.

(Zděděno od Component)
Container
Zastaralé.

Získá ten IContainer , který obsahuje Component.

(Zděděno od Component)
DesignMode
Zastaralé.

Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu.

(Zděděno od Component)
Events
Zastaralé.

Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component.

(Zděděno od Component)
Handle
Zastaralé.

Získá hodnotu představující popisovač okna pro nabídku.
IsParent
Zastaralé.

Získá hodnotu určující, zda tato nabídka obsahuje jakékoli položky nabídky. Tato vlastnost je jen ke čtení.
MdiListItem
Zastaralé.

Získá hodnotu označující MenuItem , který se používá k zobrazení seznamu více podřízených formulářů rozhraní dokumentů (MDI).
MenuItems
Zastaralé.

Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce.
Name
Zastaralé.

Získá nebo nastaví název Menu.
Site
Zastaralé.

Získá nebo nastaví ISite .Component

(Zděděno od Component)
Tag
Zastaralé.

Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku.

Metody

Name Description
CloneMenu(Menu)
Zastaralé.

Menu Zkopíruje předaný jako parametr do aktuálního Menusouboru .
CreateMenuHandle()
Zastaralé.

Vytvoří nový popisovač .Menu
CreateObjRef(Type)
Zastaralé.

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()
Zastaralé.

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose(Boolean)
Zastaralé.

Vyřaďte prostředky, jiné než paměť, které používá Menu.
Equals(Object)
Zastaralé.

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
FindMenuItem(Int32, IntPtr)
Zastaralé.

MenuItem Získá hodnotu, která obsahuje zadanou hodnotu.
FindMergePosition(Int32)
Zastaralé.

Vrátí pozici, do které se má položka nabídky vložit.
GetContextMenu()
Zastaralé.

ContextMenu Získá hodnotu, která obsahuje tuto nabídku.
GetHashCode()
Zastaralé.

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetMainMenu()
Zastaralé.

MainMenu Získá hodnotu, která obsahuje tuto nabídku.
GetService(Type)
Zastaralé.

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container.

(Zděděno od Component)
GetType()
Zastaralé.

Získá Type aktuální instance.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()
Zastaralé.

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
MemberwiseClone(Boolean)
Zastaralé.

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
MergeMenu(Menu)
Zastaralé.

Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou.
ProcessCmdKey(Message, Keys)
Zastaralé.

Zpracovává příkazový klíč.
ToString()
Zastaralé.

String Vrátí hodnotu, která představuje Menu ovládací prvek.

Událost

Name Description
Disposed
Zastaralé.

Nastane, když komponenta je uvolněna voláním Dispose() metody.

(Zděděno od Component)

Platí pro

Viz také