This documentation is archived and is not being maintained.

MenuItem.Shortcut Property

Gets or sets a value indicating the shortcut key associated with the menu item.

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

[LocalizableAttribute(true)] 
public Shortcut Shortcut { get; set; }
/** @property */
public Shortcut get_Shortcut ()

/** @property */
public void set_Shortcut (Shortcut value)

public function get Shortcut () : Shortcut

public function set Shortcut (value : Shortcut)

Not applicable.

Property Value

One of the Shortcut values. The default is Shortcut.None.

Exception typeCondition

InvalidEnumArgumentException

The assigned value is not one of the Shortcut values.

Shortcut keys provide a method for users to activate frequently used menu items in your menu system and to provide keyboard access to your application for those users who do not have access to a mouse or other pointer device.

The following code example creates a menu item, sets the caption, assigns a shortcut key, makes the menu item visible, and shows the shortcut key display for the menu item. The example requires that a MenuItem has been created that is named menuItem1.

public void SetupMyMenuItem()
{
   // Set the caption for the menu item.
   menuItem1.Text = "&New";
   // Assign a shortcut key.
   menuItem1.Shortcut = Shortcut.CtrlN;
   // Make the menu item visible.
   menuItem1.Visible = true;
   // Display the shortcut key combination.
   menuItem1.ShowShortcut = true;
}
  

public void SetupMyMenuItem()
{
    // Set the caption for the menu item.
    menuItem1.set_Text("&New");

    // Assign a shortcut key.
    menuItem1.set_Shortcut(Shortcut.CtrlN);

    // Make the menu item visible.
    menuItem1.set_Visible(true);

    // Display the shortcut key combination.
    menuItem1.set_ShowShortcut(true);
} //SetupMyMenuItem

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
Show: