MenuItem Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

MenuItem.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 jednotlivé položky, které jsou zobrazeny v rámci nebo MainMenuContextMenu.

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Použijte ToolStripMenuItem místo toho ovládací prvek.MenuItem

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

[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 class MenuItem : System.Windows.Forms.Menu

[<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 MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Dědičnost

Object

MarshalByRefObject

Component

Menu

MenuItem

Atributy

BrowsableAttribute ObsoleteAttribute

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á 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. Místo toho použijte ToolStripMenuItem.

Chcete-li zobrazit, MenuItem musíte jej 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 tuto vlastnost. Pomocí této funkce můžete identifikovat položku nabídky vybranou v seznamu vzájemně se vylučujíných položek 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 stisknout k výběru položky nabídky.

U MenuItem objektů zobrazených v aplikaci MDI (Multiple Document Interface) můžete pomocí MergeMenu této metody sloučit nabídky nadřazeného objektu MDI s podřízenými formuláři a vytvořit konsolidovanou strukturu nabídek. MenuItem Vzhledem k tomu, že nelze opakovaně použít ve více umístěních současně, například v MainMenu a a , ContextMenumůžete použít CloneMenu metodu k vytvoření kopie pro MenuItem 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. Tato Select událost umožňuje provádět úlohy, jako je poskytnutí podrobné nápovědy k položkám nabídky vaší aplikace, když uživatel umístí ukazatel myši na položku nabídky.

Konstruktory

Name	Description
MenuItem()	Zastaralé. Inicializuje prázdný MenuItem titulek.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Zastaralé. Inicializuje novou instanci MenuItem třídy se zadaným titulkem, definovanými obslužnými rutinami událostí pro objekty Clicka SelectPopup události, klávesovou zkratkou, typem sloučení a pořadím zadaným pro položku nabídky.
MenuItem(String, EventHandler, Shortcut)	Zastaralé. Inicializuje novou instanci třídy se zadaným titulkem, obslužnou rutinou události a přidruženou klávesovou zkratkou pro položku nabídky.
MenuItem(String, EventHandler)	Zastaralé. Inicializuje novou instanci třídy se zadaným titulkem a obslužnou rutinou události pro Click událost položky nabídky.
MenuItem(String, MenuItem[])	Zastaralé. Inicializuje novou instanci třídy se zadaným titulkem a polem podnabídek položek definovaných pro položku nabídky.
MenuItem(String)	Zastaralé. Inicializuje novou instanci MenuItem třídy se zadaným titulkem pro položku nabídky.

Pole

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

Vlastnosti

Name	Description
BarBreak	Zastaralé. Získá nebo nastaví hodnotu určující, zda je umístěn MenuItem na novém řádku (pro položku nabídky přidán do objektu MainMenu ) nebo v novém sloupci (pro podnabídku položku nebo položku nabídky zobrazenou ContextMenuv ).
Break	Zastaralé. 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 podnabídku zobrazenou v objektu ContextMenu).
Checked	Zastaralé. Získá nebo nastaví hodnotu označující, zda se značka zaškrtnutí zobrazí vedle textu položky nabídky.
DefaultItem	Zastaralé. Získá nebo nastaví hodnotu určující, zda položka nabídky je výchozí položka nabídky.
Enabled	Zastaralé. Získá nebo nastaví hodnotu určující, zda je položka nabídky povolena.
Handle	Zastaralé. Získá hodnotu představující popisovač okna pro nabídku. (Zděděno od Menu)
Index	Zastaralé. Získá nebo nastaví hodnotu označující pozici položky nabídky v nadřazené nabídce.
IsParent	Zastaralé. Získá hodnotu určující, zda položka nabídky obsahuje podřízené položky nabídky.
MdiList	Zastaralé. Získá nebo nastaví hodnotu určující, zda položka nabídky bude naplněna seznamem podřízených oken rozhraní MDI (Multiple Document Interface), které jsou zobrazeny v přidruženém formuláři.
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). (Zděděno od Menu)
MenuID	Zastaralé. Získá hodnotu označující identifikátor systému Windows pro tuto položku nabídky.
MenuItems	Zastaralé. Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce. (Zděděno od Menu)
MergeOrder	Zastaralé. Získá nebo nastaví hodnotu označující relativní pozici položky nabídky při sloučení s jinou.
MergeType	Zastaralé. Získá nebo nastaví hodnotu označující chování této položky nabídky při jeho sloučení s jinou.
Mnemonic	Zastaralé. Získá hodnotu označující mnemonic znak, který je přidružen k této položce nabídky.
Name	Zastaralé. Získá nebo nastaví název Menu. (Zděděno od Menu)
OwnerDraw	Zastaralé. Získá nebo nastaví hodnotu určující, zda kód, který zadáte, nakreslí položku nabídky nebo Windows nakreslí položku nabídky.
Parent	Zastaralé. Získá hodnotu označující nabídku, která obsahuje tuto položku nabídky.
RadioCheck	Zastaralé. Získá nebo nastaví hodnotu označující, zda MenuItem, pokud je zaškrtnuto, zobrazí přepínač místo zaškrtnutí.
Shortcut	Zastaralé. Získá nebo nastaví hodnotu označující klávesovou zkratku přidruženou k položce nabídky.
ShowShortcut	Zastaralé. Získá nebo nastaví hodnotu určující, zda je klávesová zkratka přidružená k položce nabídky zobrazena vedle titulku položky nabídky.
Tag	Zastaralé. Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku. (Zděděno od Menu)
Text	Zastaralé. Získá nebo nastaví hodnotu označující titulek položky nabídky.
Visible	Zastaralé. Získá nebo nastaví hodnotu určující, zda položka nabídky je viditelná.

Metody

Name	Description
CloneMenu()	Zastaralé. Vytvoří kopii aktuálního MenuItem.
CloneMenu(Menu)	Zastaralé. Menu Zkopíruje předaný jako parametr do aktuálního Menusouboru . (Zděděno od Menu)
CloneMenu(MenuItem)	Zastaralé. Vytvoří kopii zadaného MenuItemsouboru .
CreateMenuHandle()	Zastaralé. Vytvoří nový popisovač .Menu (Zděděno od Menu)
FindMenuItem(Int32, IntPtr)	Zastaralé. MenuItem Získá hodnotu, která obsahuje zadanou hodnotu. (Zděděno od Menu)
FindMergePosition(Int32)	Zastaralé. Vrátí pozici, do které se má položka nabídky vložit. (Zděděno od Menu)
GetContextMenu()	Zastaralé. ContextMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
GetMainMenu()	Zastaralé. MainMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
MergeMenu()	Zastaralé. Sloučí to MenuItem s jinou MenuItem a vrátí výslednou sloučenou MenuItem.
MergeMenu(Menu)	Zastaralé. Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou. (Zděděno od Menu)
MergeMenu(MenuItem)	Zastaralé. Sloučí jinou položku nabídky s touto položkou nabídky.
OnClick(EventArgs)	Zastaralé. Click Vyvolá událost.
OnDrawItem(DrawItemEventArgs)	Zastaralé. DrawItem Vyvolá událost.
OnInitMenuPopup(EventArgs)	Zastaralé. Popup Vyvolá událost.
OnMeasureItem(MeasureItemEventArgs)	Zastaralé. MeasureItem Vyvolá událost.
OnPopup(EventArgs)	Zastaralé. Popup Vyvolá událost.
OnSelect(EventArgs)	Zastaralé. Select Vyvolá událost.
PerformClick()	Zastaralé. Vygeneruje Click událost pro MenuItem, simulující kliknutí uživatelem.
PerformSelect()	Zastaralé. Select Vyvolá událost pro tuto položku nabídky.
ProcessCmdKey(Message, Keys)	Zastaralé. Zpracovává příkazový klíč. (Zděděno od Menu)

Událost

Name	Description
Click	Zastaralé. Nastane 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.
DrawItem	Zastaralé. Nastane, OwnerDraw když je vlastnost položky nabídky nastavena true a požadavek je proveden nakreslit položku nabídky.
MeasureItem	Zastaralé. Nastane, když nabídka potřebuje znát velikost položky nabídky před jeho nakreslením.
Popup	Zastaralé. Vyvolá se před zobrazením seznamu položek nabídky položky nabídky.
Select	Zastaralé. Nastane, když uživatel umístí ukazatel na položku nabídky.

Viz také

• MainMenu
• Menu
• MenuMerge
• ContextMenu