This documentation is archived and is not being maintained.

MenuItem.OnSelect Method

Raises the Select event.

[Visual Basic]
Protected Overridable Sub OnSelect( _
   ByVal e As EventArgs _
)
[C#]
protected virtual void OnSelect(
 EventArgs e
);
[C++]
protected: virtual void OnSelect(
 EventArgs* e
);
[JScript]
protected function OnSelect(
   e : EventArgs
);

Parameters

e
An EventArgs that contains the event data.

Remarks

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

Notes to Inheritors:  When overriding OnSelect in a derived class, be sure to call the base class's OnSelect method.

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 Language Filter 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

Show: