MenuItem::PerformSelect Method ()

 

Raises the Select event for this menu item.

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

public:
virtual void PerformSelect()

This method allows you to raise the Select event without passing any event information to the event handler.

In this example you programmatically select a menu item by using the PerformSelect method. First, you create a main menu (mainMenu1) and add to it two menu items, menuItem1 (File) and menuItem2 (Edit). You also use the Select event to send data to the event handler when a menu item is selected. Then you use the PerformSelect method to select the File menu item. When you start the application, the File menu item is selected, and a message box that contains the text "The File menu is selected." appears on the screen. The example requires that you have created a Form named Form1.

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

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

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

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

      // Add functionality to the menu items.
      menuItem1->Select += gcnew System::EventHandler( this, &Form1::menuItem1_Select );
      menuItem2->Select += gcnew System::EventHandler( this, &Form1::menuItem2_Select );

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

      // Select the File menu item.
      menuItem1->PerformSelect();
   }

private:
   void menuItem1_Select( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      MessageBox::Show( "You selected the File menu.", "The Event Information" );
   }

   void menuItem2_Select( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      MessageBox::Show( "You selected the Edit menu.", "The Event Information" );
   }

.NET Framework
Available since 1.1
Return to top
Show: