Menu.MenuItems Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets a value indicating the collection of MenuItem objects associated with the menu.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Menu.MenuItemCollection MenuItems { get; }

Property Value

Type: System.Windows.Forms.Menu.MenuItemCollection

A System.Windows.Forms.Menu.MenuItemCollection that represents the list of MenuItem objects stored in the menu.

You can use this property to obtain a reference to the list of menu items that are currently stored in the menu. For MainMenu and ContextMenu objects, the MenuItems property contains the entire menu structure in the control. For the MenuItem class, the MenuItems property contains the list of submenu items associated with the MenuItem. With the reference to the collection of menu items for the menu (provided by this property), you can add and remove menu items, determine the total number of menu items, and clear the list of menu items from the collection. For more information on maintaining the menu item collection for a menu, see the System.Windows.Forms.Menu.MenuItemCollection documentation.

The following code example creates an instance of the derived class, MainMenu, and adds a MenuItem object to its collection of MenuItem objects. This example requires that the method defined in this example is located within the class for a form and called by a method in that form class.

private void InitializeMyMainMenu()
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");

   /* Use the MenuItems property to call the Add method
      to add the MenuItem to the MainMenu menu item collection. */
   mainMenu1.MenuItems.Add (menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;

.NET Framework
Available since 1.1
Return to top