MenuItem.Break Property


Gets or sets a value indicating whether the item is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a menu item or submenu item displayed in a ContextMenu).

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

public bool Break { get; set; }

Property Value

Type: System.Boolean

true if the menu item is placed on a new line or in a new column; false if the menu item is left in its default placement. The default is false.

You can use the Break property to create a menu where each menu is placed next to each other horizontally instead of in a vertical list. You can also use this property to create a menu bar that contains multiple rows of top-level menu items.

The following code example creates a menu with two top-level menu items on the top row and one menu item on the bottom row.

public void CreateMyMenus()
   // Create three top-level menu items.
   MenuItem menuItem1 = new MenuItem("&File");
   MenuItem menuItem2 = new MenuItem("&Options");
   MenuItem menuItem3 = new MenuItem("&Edit");
   // Place the "Edit" menu on a new line in the menu bar.
   menuItem3.Break = true;

.NET Framework
Available since 1.1
Return to top