MenuItem.DefaultItem Property

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.

Gets or sets a value indicating whether the menu item is the default menu item.

public:
 property bool DefaultItem { bool get(); void set(bool value); };

public bool DefaultItem { get; set; }

member this.DefaultItem : bool with get, set

Public Property DefaultItem As Boolean

Property Value

Boolean

true if the menu item is the default item in a menu; otherwise, false. The default is false.

Examples

The following code example creates a menu item with two submenu items. The example sets menuItem2 as the default menu item using the DefaultItem property.

public:
   void CreateMyMenus()
   {
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      MenuItem^ menuItem2 = gcnew MenuItem( "&New" );
      MenuItem^ menuItem3 = gcnew MenuItem( "&Open" );
      // Make menuItem2 the default menu item.
      menuItem2->DefaultItem = true;
   }

public void CreateMyMenus()
{
   MenuItem menuItem1 = new MenuItem("&File");
   MenuItem menuItem2 = new MenuItem("&New");
   MenuItem menuItem3 = new MenuItem("&Open");
   // Make menuItem2 the default menu item.
   menuItem2.DefaultItem = true;
}

Public Sub CreateMyMenus()
    Dim menuItem1 As New MenuItem("&File")
    Dim menuItem2 As New MenuItem("&New")
    Dim menuItem3 As New MenuItem("&Open")
    ' Make menuItem2 the default menu item.
    menuItem2.DefaultItem = True
End Sub

Remarks

The default menu item for a menu is boldfaced. When the user double-clicks a submenu that contains a default item, the default item is selected, and the submenu is closed. You can use the DefaultItem property to indicate, the default action that is expected in a menu or shortcut menu.

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