MenuItem Třída

Definice

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 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

Pole

Vlastnosti

Metody

Událost

Platí pro

Viz také

• MainMenu
• Menu
• MenuMerge
• ContextMenu