Export (0) Print
Expand All

MenuItem.Checked Property

Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

member Checked : bool with get, set

Property Value

Type: System.Boolean
true if there is a check mark next to the menu item; otherwise, false. The default is false.


The MenuItem is a top-level menu or has children.

You can use the Checked property in combination with other menu items in a menu to provide state for an application. For example, you can place a check mark on a menu item in a group of items to identify the size of the font to be displayed for the text in an application. You can also use the Checked property to identify the selected menu item in a group of mutually exclusive menu items.


This property cannot be set to true for top-level menu items.

The following code example uses the Checked property to provide the state in an application. In this example, a group of menu items are used to specify the color for the text in a TextBox control. The event handler provided is used by the Click event of three menu items. Each menu item specifies a text color, menuItemRed (Red), menuItemGreen (Green), or menuItemBlue (Blue). The event handler determines which menu item was clicked, places a checkmark to the selected menu item, and changes the text color of the form's TextBox control. The example requires that the System.Drawing namespace has been added to the form that this code is placed in. The example also requires that a TextBox has been added to the form that this example code is located in that is named textBox1.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft