MenuItem.Break 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 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

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.

Attributes: BrowsableAttribute

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

Jaa