MenuItem.Break Property

Definition

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).

public:
 property bool Break { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool Break { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.Break : bool with get, set
Public Property Break As Boolean

Property Value

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.

Attributes

Examples

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 = gcnew MenuItem( "&File" );
      MenuItem^ menuItem2 = gcnew MenuItem( "&Options" );
      MenuItem^ menuItem3 = gcnew MenuItem( "&Edit" );
      // Place the "Edit" menu on a new line in the menu bar.
      menuItem3->Break = true;
   }
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;
}
Public Sub CreateMyMenus()
    ' Create three top-level menu items.
    Dim menuItem1 As New MenuItem("&File")
    Dim menuItem2 As New MenuItem("&Options")
    Dim menuItem3 As New MenuItem("&Edit")
    ' Place the "Edit" menu on a new line in the menu bar.
    menuItem3.Break = True
End Sub

Remarks

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.

Applies to

See also