Export (0) Print
Expand All

MenuItem.MenuItem(String, EventHandler) Constructor

Initializes a new instance of the class with a specified caption and event handler for the Click event of the menu item.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public MenuItem (
	string text,
	EventHandler onClick
)
public MenuItem (
	String text, 
	EventHandler onClick
)
public function MenuItem (
	text : String, 
	onClick : EventHandler
)
Not applicable.

Parameters

text

The caption for the menu item.

onClick

The EventHandler that handles the Click event for this menu item.

When you specify a caption for your menu item with the text parameter, you can also specify an access key by placing an '&' before the character to be used as the access key. For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". You can use this feature to provide keyboard navigation for your menus.

Setting the text parameter to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

In addition, you can use this constructor to specify a delegate that will handle the Click event for the menu item being created. The EventHandler that you pass to this constructor must be configured to call an event handler that can handle the Click event. For more information on handling events, see Events and Delegates.

The following code example creates a MenuItem object with a specified caption and an EventHandler delegate connected to an event handler that will handle the Click event for the menu item.

public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}
  

public void CreateMyMenuItem()
{
    // Create an instance of MenuItem with caption and an event handler
    MenuItem menuItem1 = new MenuItem("&New",
        new System.EventHandler(this.menuItem1_Click));
} //CreateMyMenuItem

// This method is an event handler for menuItem1 to use
// when connecting its event handler.
private void menuItem1_Click(Object sender, System.EventArgs e)
{
    // Code goes here that handles the Click event.
} //menuItem1_Click

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft