Menu Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Tato třída není k dispozici v .NET Core 3.1 a novějších verzích. Použijte a ToolStripDropDownMenu místo toho nahraďte ToolStripDropDown 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)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Dědičnost: Object

MarshalByRefObject

Component
Menu

Odvozené: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Atributy: ListBindableAttribute

Příklady

Následující příklad kódu používá odvozenou třídu , MenuItemk vytvoření struktury nabídky pro formulář. Ukázkový kód přidá MenuItem položku nabídky nejvyšší úrovně, přidá do ní podnabídku pro výběr velikosti písma a pak přidá dvě podnabídky k této položce nabídky, které představují velké a malé volby písma v aplikaci. Příklad vyžaduje, aby byl MainMenu objekt pojmenovaný mainMenu1 a čtyři MenuItem objekty s názvem menuItem1, , menuItem3``menuItem2a 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

Poznámky

Tato třída není k dispozici 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 MainMenutřídy , 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 ContextMenu objektu, který slouží 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. Pro nebo MainMenu ContextMenu, tato vlastnost obsahuje všechny MenuItem objekty, které jsou zobrazeny. Pro vlastnost MenuItem MenuItems představuje podnabídky přidružené k ní.

Kromě vlastností, které jsou poskytovány pro všechny odvozené třídy nabídek, Menu třída také poskytuje metody, jako CloneMenu MergeMenua , 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 MainMenu, ContextMenunebo MenuItem.

Konstruktory

Menu(MenuItem[])

Inicializuje novou instanci Menu třídy.

Pole

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

Vlastnosti

CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	IContainer Získá ten, který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Handle	Získá hodnotu představující úchyt okna pro nabídku.
IsParent	Získá hodnotu označující, zda tato nabídka obsahuje jakékoli položky nabídky. Tato vlastnost je jen ke čtení.
MdiListItem	Získá hodnotu označující MenuItem , že se používá k zobrazení seznamu více podřízených formulářů rozhraní dokumentů (MDI).
MenuItems	Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce.
Name	Získá nebo nastaví název .Menu
Site	Získá nebo nastaví ISite of the Component. (Zděděno od Component)
Tag	Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku.

Metody

CloneMenu(Menu)	Zkopíruje předanou Menu jako parametr do aktuálního Menusouboru .
CreateMenuHandle()	Vytvoří nový popisovač .Menu
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Odstraní prostředky, jiné než paměť, které používá Menu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindMenuItem(Int32, IntPtr)	MenuItem Získá hodnotu, která obsahuje zadanou hodnotu.
FindMergePosition(Int32)	Vrátí pozici, do které se má položka nabídky vložit.
GetContextMenu()	ContextMenu Získá tu, která obsahuje tuto nabídku.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetMainMenu()	MainMenu Získá tu, která obsahuje tuto nabídku.
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou službou Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Type Získá aktuální instanci. (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()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět. (Zděděno od MarshalByRefObject)
MergeMenu(Menu)	Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou.
ProcessCmdKey(Message, Keys)	Zpracovává příkazový klíč.
ToString()	String Vrátí hodnotu, která představuje Menu ovládací prvek.

událost

Disposed

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

(Zděděno od Component)

Platí pro