This documentation is archived and is not being maintained.

MenuItem.DefaultItem Property

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

[Visual Basic]
Public Property DefaultItem As Boolean
[C#]
public bool DefaultItem {get; set;}
[C++]
public: __property bool get_DefaultItem();
public: __property void set_DefaultItem(bool);
[JScript]
public function get DefaultItem() : Boolean;
public function set DefaultItem(Boolean);

Property Value

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

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.

Example

[Visual Basic, C#, C++] The following example creates a menu item with two submenu items. The example sets menuItem2 as the default menu item using the DefaultItem property.

[Visual Basic] 
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


[C#] 
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;
}


[C++] 
public:
 void CreateMyMenus()
 {
    MenuItem* menuItem1 = new MenuItem(S"&File");
    MenuItem* menuItem2 = new MenuItem(S"&New");
    MenuItem* menuItem3 = new MenuItem(S"&Open");
    // Make menuItem2 the default menu item.
    menuItem2->DefaultItem = true;
 }
 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

MenuItem Class | MenuItem Members | System.Windows.Forms Namespace

Show: