Menu::MenuItemCollection::Clear Method ()

 

Removes all MenuItem objects from the menu item collection.

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

public:
virtual void Clear()

Implements

IList::Clear()

You can use this method to clear the entire collection of menu items from a menu. To remove an individual menu item from the collection, use the Remove method. To add new MenuItem objects to the collection, use the Add method.

In this example, you create a main menu, myMainMenu, with two MenuItem objects, File and Edit. The File menu has three submenu items, New, Open, and Exit. Using the Clear method, you remove all the MenuItem objects in the File menu collection. This program requires that you have already created a Form named Form1.

void InitializeMyMenu()
{
   // Create the MainMenu Object*.
   MainMenu^ myMainMenu = gcnew MainMenu;

   // Create the MenuItem objects.
   MenuItem^ fileMenu = gcnew MenuItem( "&File" );
   MenuItem^ editMenu = gcnew MenuItem( "&Edit" );
   MenuItem^ newFile = gcnew MenuItem( "&New" );
   MenuItem^ openFile = gcnew MenuItem( "&Open" );
   MenuItem^ exitProgram = gcnew MenuItem( "E&xit" );

   // Add the MenuItem objects to myMainMenu.
   myMainMenu->MenuItems->Add( fileMenu );
   myMainMenu->MenuItems->Add( editMenu );

   // Add three submenus to the File menu.
   fileMenu->MenuItems->Add( newFile );
   fileMenu->MenuItems->Add( openFile );
   fileMenu->MenuItems->Add( exitProgram );

   // Assign myMainMenu to the form.
   this->Menu = myMainMenu;

   // Clear the File menu items. 
   fileMenu->MenuItems->Clear();
}

.NET Framework
Available since 1.1
Return to top
Show: