MenuItem::BarBreak Property
Gets or sets a value indicating whether the MenuItem is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a submenu item or menu item displayed in a ContextMenu).
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: [BrowsableAttribute(false)] property bool BarBreak { bool get(); void set(bool value); }
Property Value
Type: System::Booleantrue 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 BarBreak property to create a menu where each menu item 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.
This property differs from the Break property in that a bar is displayed on the left edge of each menu item that has the Break property set to true. The bar is only displayed when the menu item is not a top-level menu item.
The following code example creates a MenuItem with two submenu items. The two submenu items are displayed horizontally instead of vertically using the BarBreak property.
public: void CreateMyMenus() { // Create three top-level menu items. MenuItem^ menuItem1 = gcnew MenuItem( "&File" ); MenuItem^ menuItem2 = gcnew MenuItem( "&New" ); MenuItem^ menuItem3 = gcnew MenuItem( "&Open" ); // Set the BarBreak property to display horizontally. menuItem2->BarBreak = true; menuItem3->BarBreak = true; // Add menuItem2 and menuItem3 to the menuItem1's list of menu items. menuItem1->MenuItems->Add( menuItem2 ); menuItem1->MenuItems->Add( menuItem3 ); }
Available since 1.1