MenuItem.OnSelect(EventArgs) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 10

Share via