Sdílet prostřednictvím


MenuItem Třída

Definice

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

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 MainMenuContextMenu. 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 MainMenuContextMenua , 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 SelectPopup ; 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

Viz také