MenuItem::Click Event

 

Occurs when the menu item is clicked or selected using a shortcut key or access key defined for the menu item.

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

public:
event EventHandler^ Click {
	void add(EventHandler^ value);
	void remove(EventHandler^ value);
}

The Click event occurs when this MenuItem is clicked by the user. This event also occurs if the user selects the menu item using the keyboard and presses the Enter key. It can also occur if an access key or shortcut key is pressed that is associated with the MenuItem. For more information about handling events, see Handling and Raising Events.

System_CAPS_noteNote

If the MenuItems property for the MenuItem contains any items, this event is not raised. This event is not raised for parent menu items.

The following code example demonstrates how to use the Click event to perform tasks when a MenuItem is clicked. The example creates a MainMenu called mainMenu1 and adds two MenuItem objects, topMenuItem (File) and menuItem1 (Open). It then connects the Click event to the menuItem1_Click event handler. When the user clicks the Open menu item, an OpenFileDialog is initialized and displayed. The example requires that you have created a Form named Form1.

public:
   void CreateMyMenu()
   {
      // Create a main menu object.
      MainMenu^ mainMenu1 = gcnew MainMenu;

      // Create empty menu item objects.
      MenuItem^ topMenuItem = gcnew MenuItem;
      MenuItem^ menuItem1 = gcnew MenuItem;

      // Set the caption of the menu items.
      topMenuItem->Text = "&File";
      menuItem1->Text = "&Open";

      // Add the menu items to the main menu.
      topMenuItem->MenuItems->Add( menuItem1 );
      mainMenu1->MenuItems->Add( topMenuItem );

      // Add functionality to the menu items using the Click event. 
      menuItem1->Click += gcnew System::EventHandler( this, &Form1::menuItem1_Click );

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

private:
   void menuItem1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Create a new OpenFileDialog and display it.
      OpenFileDialog^ fd = gcnew OpenFileDialog;
      fd->DefaultExt = "*.";
      fd->ShowDialog();
   }

.NET Framework
Available since 1.1
Return to top
Show: