MenuItem 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 jednotlivou položku, která se zobrazí v rámci objektu MainMenu nebo ContextMenu.

Tato třída není k dispozici v .NET Core 3.1 a novějších verzích. Místo toho použijte ToolStripMenuItem příkaz , který nahradí MenuItem ovládací prvek.

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Dědičnost: Object

MarshalByRefObject

Component

Menu
MenuItem

Příklady

Následující příklad kódu vytvoří strukturu nabídky pro formulář. Ukázkový kód přidá MenuItem položku nabídky nejvyšší úrovně, přidá položku podnabídky pro výběr velikosti písma a poté přidá dvě položky 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 existoval MainMenu objekt s názvem mainMenu1 a čtyři MenuItem objekty s názvem menuItem1, menuItem2, menuItem3a 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. Místo toho použijte ToolStripMenuItem.

Aby se zobrazil MenuItem , musíte ho přidat do nebo MainMenu ContextMenu. Chcete-li vytvořit podnabídky, můžete přidat MenuItem objekty do MenuItems vlastnosti nadřazeného MenuItemobjektu .

Třída MenuItem poskytuje vlastnosti, které umožňují konfigurovat vzhled a funkce položky nabídky. Pokud chcete zobrazit značku zaškrtnutí vedle položky nabídky, použijte Checked vlastnost . Tuto funkci můžete použít k identifikaci položky nabídky, která je vybrána v seznamu vzájemně se vylučující položky nabídky. Pokud máte například sadu položek nabídky pro nastavení barvy textu v ovládacím TextBox prvku, můžete pomocí Checked vlastnosti určit, která barva je aktuálně vybrána. Vlastnost Shortcut lze použít k definování kombinace klávesnice, kterou lze stisknutím vybrat položku nabídky.

U MenuItem objektů zobrazených v aplikaci MDI (Multiple Document Interface) můžete použít metodu MergeMenu ke sloučení nabídek nadřazeného objektu MDI s nabídkami podřízených formulářů a vytvořit tak sloučenou strukturu nabídek. MenuItem Vzhledem k tomu, že objekt nelze znovu použít na více místech současně, například v MainMenu ContextMenua , můžete použít metodu CloneMenu k vytvoření kopie objektu MenuItem pro použití v jiném umístění.

Událost Popup umožňuje provádět úkoly před zobrazením nabídky. Můžete například vytvořit obslužnou rutinu události pro tuto událost, která zobrazí nebo skryje položky nabídky na základě stavu kódu. Událost Select umožňuje provádět úlohy, jako je poskytování podrobné nápovědy pro položky nabídky aplikace, když uživatel umístí ukazatel myši na položku nabídky.

Konstruktory

MenuItem()	Inicializuje s prázdnou MenuItem popis.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inicializuje novou instanci MenuItem třídy se zadaným popis; definované obslužné rutiny událostí pro Clickudálosti a Select Popup ; klávesová zkratka; typ sloučení; a pořadí zadané pro položku nabídky.
MenuItem(String)	Inicializuje novou instanci MenuItem třídy se zadaným popis pro položku nabídky.
MenuItem(String, EventHandler)	Inicializuje novou instanci třídy se zadaným popis a obslužnou rutinou Click události pro událost položky nabídky.
MenuItem(String, EventHandler, Shortcut)	Inicializuje novou instanci třídy se zadaným popis, obslužnou rutinou události a přidruženou klávesovou zkratkou pro položku nabídky.
MenuItem(String, MenuItem[])	Inicializuje novou instanci třídy se zadaným popis a pole podnabídky položky definované pro položku nabídky.

Pole

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

Vlastnosti

BarBreak	Získá nebo nastaví hodnotu označující, zda MenuItem je umístěn na nový řádek (pro položku nabídky přidanou do objektu MainMenu ) nebo v novém sloupci (pro položku podnabídky nebo položku nabídky zobrazenou v objektu ContextMenu).
Break	Získá nebo nastaví hodnotu označující, zda je položka umístěna na nový řádek (pro položku nabídky přidanou do objektu MainMenu ) nebo v novém sloupci (pro položku nabídky nebo položku podnabídky zobrazenou v objektu ContextMenu).
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Checked	Získá nebo nastaví hodnotu označující, zda se vedle textu položky nabídky zobrazí značka zaškrtnutí.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DefaultItem	Získá nebo nastaví hodnotu označující, zda je položka nabídky výchozí položkou nabídky.
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Enabled	Získá nebo nastaví hodnotu označující, zda je povolena položka nabídky.
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í popisovač okna pro nabídku. (Zděděno od Menu)
Index	Získá nebo nastaví hodnotu označující pozici položky nabídky v nadřazené nabídce.
IsParent	Získá hodnotu označující, zda položka nabídky obsahuje podřízené položky nabídky.
MdiList	Získá nebo nastaví hodnotu označující, zda bude položka nabídky naplněna seznamem podřízených oken rozhraní MDI (Multiple Document Interface), které jsou zobrazeny v přidruženém formuláři.
MdiListItem	Získá hodnotu označující MenuItem , která se používá k zobrazení seznamu podřízených formulářů rozhraní MDI (Více dokumentů). (Zděděno od Menu)
MenuID	Získá hodnotu označující identifikátor systému Windows pro tuto položku nabídky.
MenuItems	Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce. (Zděděno od Menu)
MergeOrder	Získá nebo nastaví hodnotu označující relativní pozici položky nabídky při sloučení s jinou.
MergeType	Získá nebo nastaví hodnotu označující chování této položky nabídky, když je její nabídka sloučena s jinou.
Mnemonic	Získá hodnotu označující mnemotechnický znak, který je přidružen k této položce nabídky.
Name	Získá nebo nastaví název objektu Menu. (Zděděno od Menu)
OwnerDraw	Získá nebo nastaví hodnotu označující, zda kód, který zadáte, nakreslí položku nabídky nebo systém Windows nakreslí položku nabídky.
Parent	Získá hodnotu označující nabídku, která obsahuje tuto položku nabídky.
RadioCheck	Získá nebo nastaví hodnotu označující, zda MenuItem, pokud je zaškrtnuto, zobrazí přepínač místo značky zaškrtnutí.
Shortcut	Získá nebo nastaví hodnotu označující klávesovou zkratku přidruženou k položce nabídky.
ShowShortcut	Získá nebo nastaví hodnotu označující, zda je zobrazena klávesová zkratka, která je přidružena k položce nabídky popis.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
Tag	Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku. (Zděděno od Menu)
Text	Získá nebo nastaví hodnotu označující popis položky nabídky.
Visible	Získá nebo nastaví hodnotu označující, zda je položka nabídky viditelná.

Metody

CloneMenu()	Vytvoří kopii aktuálního MenuItemsouboru .
CloneMenu(Menu)	Zkopíruje předaný Menu parametr do aktuálního Menuparametru . (Zděděno od Menu)
CloneMenu(MenuItem)	Vytvoří kopii zadaného MenuItemsouboru .
CreateMenuHandle()	Vytvoří nový popisovač pro Menu. (Zděděno od Menu)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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ěť) používané nástrojem MenuItem.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindMenuItem(Int32, IntPtr)	Získá , MenuItem která obsahuje zadanou hodnotu. (Zděděno od Menu)
FindMergePosition(Int32)	Vrátí pozici, na které má být položka nabídky vložena do nabídky. (Zděděno od Menu)
GetContextMenu()	Získá , ContextMenu která obsahuje tuto nabídku. (Zděděno od Menu)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetMainMenu()	Získá , MainMenu která obsahuje tuto nabídku. (Zděděno od Menu)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
MergeMenu()	Sloučí toto MenuItem s jiným MenuItem a vrátí výslednou sloučenou MenuItemhodnotu .
MergeMenu(Menu)	Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou. (Zděděno od Menu)
MergeMenu(MenuItem)	Sloučí jinou položku nabídky s touto položkou nabídky.
OnClick(EventArgs)	Click Vyvolá událost.
OnDrawItem(DrawItemEventArgs)	DrawItem Vyvolá událost.
OnInitMenuPopup(EventArgs)	Popup Vyvolá událost.
OnMeasureItem(MeasureItemEventArgs)	MeasureItem Vyvolá událost.
OnPopup(EventArgs)	Popup Vyvolá událost.
OnSelect(EventArgs)	Select Vyvolá událost.
PerformClick()	Vygeneruje Click událost pro MenuItem, simulující kliknutí uživatelem.
PerformSelect()	Select Vyvolá událost pro tuto položku nabídky.
ProcessCmdKey(Message, Keys)	Zpracuje příkazový klíč. (Zděděno od Menu)
ToString()	Vrátí řetězec, který představuje MenuItem.

Událost

Click	Vyvolá se při kliknutí nebo výběru položky nabídky pomocí klávesové zkratky nebo přístupové klávesy definované pro položku nabídky.
Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
DrawItem	Vyvolá se, OwnerDraw když je vlastnost položky nabídky nastavena na `true` a je proveden požadavek na vykreslení položky nabídky.
MeasureItem	Vyvolá se v případě, že nabídka potřebuje znát velikost položky nabídky před jejím vykreslení.
Popup	Nastane před zobrazením seznamu položek nabídky.
Select	Vyvolá se, když uživatel umístí ukazatel na položku nabídky.

Platí pro