MenuItem.Select Event

Occurs when the user places the cursor over a menu item.

[Visual Basic]
Public Event Select As EventHandler
[C#]
public event EventHandler Select;
[C++]
public: __event EventHandler* Select;

[JScript] In JScript, you can handle the events defined by a class, but you cannot define your own.

Event Data

The event handler receives an argument of type EventArgs.

Remarks

This event is typically raised when the user places the mouse cursor over the menu item. The event can also be raised when the user highlights a menu item using the keyboard by scrolling to the menu item with the arrow keys. You can use this event to display a detailed help string pertaining to this menu item in an application's status bar. For more information about handling events, see Consuming Events.

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

Example

[Visual Basic, C#, C++] The following example demonstrates how to use the Select event of the MenuItem class to assign help text to a StatusBarPanel of a StatusBar control. This example assumes that MenuItem objects named menuOpen, menuSave, and menuExit are added to a MainMenu control on a form. The example also assumes that a StatusBar control, named statusBar1 has been added to the form. The StatusBar control should contain a StatusBarPanel.

[Visual Basic] 
Private Sub MenuSelected(ByVal sender As Object, ByVal e As System.EventArgs) _
                     Handles menuOpen.Select, menuExit.Select, menuSave.Select
   If sender Is menuOpen Then
      StatusBar1.Panels(0).Text = "Opens a file to edit"
   Else
      If sender Is menuSave Then
         StatusBar1.Panels(0).Text = "Saves the current file"
      Else
         If sender Is menuExit Then
            StatusBar1.Panels(0).Text = "Exits the application"
         Else
            StatusBar1.Panels(0).Text = "Ready"
         End If
      End If
   End If
End Sub

[C#] 
private void MenuSelected(object sender, System.EventArgs e)
{
   if (sender == menuOpen)
      statusBar1.Panels[0].Text = "Opens a file to edit";
   else if(sender == menuSave)
      statusBar1.Panels[0].Text = "Saves the current file";
   else if(sender == menuExit)
      statusBar1.Panels[0].Text = "Exits the application";
   else
      statusBar1.Panels[0].Text = "Ready";
}

[C++] 
private:
   void MenuSelected(Object* sender, System::EventArgs* /*e*/)
   {
      if (sender == menuOpen)
         statusBar1->Panels->Item[0]->Text = S"Opens a file to edit";
      else if(sender == menuSave)
         statusBar1->Panels->Item[0]->Text = S"Saves the current file";
      else if(sender == menuExit)
         statusBar1->Panels->Item[0]->Text = S"Exits the application";
      else
         statusBar1->Panels->Item[0]->Text = S"Ready";
   }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

MenuItem Class | MenuItem Members | System.Windows.Forms Namespace | Click