MenuItem 类

定义

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

继承

Object

MarshalByRefObject

Component

Menu

MenuItem

示例

下面的代码示例为窗体创建菜单结构。 示例代码添加 一个 MenuItem 表示顶级菜单项的 ，向它添加一个子菜单项以选择字号，然后将两个子菜单项添加到表示应用程序中的大字体和小字体选项的菜单项。 该示例要求有一MainMenu个名为 的对象和四MenuItem个名为 mainMenu1menuItem1、menuItem2、 menuItem3和 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

注解

此类在 .NET Core 3.1 及更高版本中不可用。 请改用 ToolStripMenuItem。

若要 MenuItem 显示 ，必须将其添加到 MainMenu 或 ContextMenu。 若要创建子菜单，可以将 对象添加到MenuItemMenuItems父 MenuItem的 属性。

类 MenuItem 提供属性，使你能够配置菜单项的外观和功能。 若要在菜单项旁边显示检查标记，请使用 Checked 属性。 可以使用此功能来标识在互斥菜单项列表中选择的菜单项。 例如，如果有一组菜单项用于设置控件中的 TextBox 文本颜色，则可以使用 Checked 属性来标识当前选择的颜色。 属性 Shortcut 可用于定义可按下以选择菜单项的键盘组合。

对于 MenuItem 多文档界面 (MDI) 应用程序中显示的对象，可以使用 MergeMenu 方法将 的 MDI 父菜单与其子窗体的菜单合并，以创建合并的菜单结构。 MenuItem由于 不能同时在多个位置（例如 在 和 ContextMenu中MainMenu）重复使用，因此可以使用 CloneMenu 方法创建 MenuItem 的副本，以便在其他位置使用。

事件 Popup 使您能够在显示菜单之前执行任务。 例如，可以为此事件创建事件处理程序，以便根据代码的状态显示或隐藏菜单项。 事件 Select 使你能够执行一些任务，例如，当用户将鼠标指针放在菜单项上时，为应用程序的菜单项提供详细帮助。

构造函数

字段

属性

方法

事件

适用于

另请参阅

• MainMenu
• Menu
• MenuMerge
• ContextMenu