MenuItem.OnSelect(EventArgs) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Raises the Select event.

protected:
 virtual void OnSelect(EventArgs ^ e);

protected virtual void OnSelect (EventArgs e);

abstract member OnSelect : EventArgs -> unit
override this.OnSelect : EventArgs -> unit

Protected Overridable Sub OnSelect (e As EventArgs)

Parameters

e

EventArgs

An EventArgs that contains the event data.

Examples

The following code 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 requires that MenuItem objects named menuOpen, menuSave, and menuExit are added to a MainMenu control on a form. The example also requires that a StatusBar control, named statusBar1 has been added to the form. The StatusBar control should contain a StatusBarPanel.

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";
   }

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";
}

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

Remarks

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

Notes to Inheritors

When overriding OnSelect(EventArgs) in a derived class, be sure to call the base class's OnSelect(EventArgs) method.