MenuItem.BarBreak-Eigenschaft

Ruft einen Wert ab, der angibt, ob MenuItem in einer neuen Zeile platziert wird (für ein Menüelement, das einem MainMenu-Objekt hinzugefügt wurde) oder ob es in einer neuen Spalte platziert wird (für ein Untermenüelement oder Menüelement, das in einem ContextMenu angezeigt wird), oder legt diesen Wert fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property BarBreak As Boolean
'Usage
Dim instance As MenuItem
Dim value As Boolean

value = instance.BarBreak

instance.BarBreak = value

public bool BarBreak { get; set; }

public:
property bool BarBreak {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_BarBreak ()

/** @property */
public void set_BarBreak (boolean value)

public function get BarBreak () : boolean

public function set BarBreak (value : boolean)

Eigenschaftenwert

true, wenn das Menüelement in einer neuen Zeile oder Spalte platziert wird; false, wenn das Menüelement an seiner Standardposition verbleibt. Der Standardwert ist false.

Hinweise

Mithilfe der BarBreak-Eigenschaft können Sie ein Menü erstellen, in dem alle Menüelemente horizontal nebeneinander statt in einer vertikalen Liste positioniert werden. Sie können mit dieser Eigenschaft auch eine Menüleiste erstellen, die mehrere Zeilen von Menüelementen der obersten Ebene enthält.

Der Unterschied dieser Eigenschaft zur Break-Eigenschaft besteht darin, dass am linken Rand jedes Menüelements, dessen Break-Eigenschaft auf true festgelegt ist, eine Leiste angezeigt wird. Die Leiste wird nur angezeigt, wenn es sich bei dem Menüelement nicht um ein Menüelement der obersten Ebene handelt.

Beispiel

Im folgenden Codebeispiel wird ein MenuItem mit zwei Untermenüelementen erstellt. Die beiden Untermenüelemente werden unter Verwendung der BarBreak-Eigenschaft nicht vertikal, sondern horizontal angezeigt.

Public Sub CreateMyMenus()
    ' Create three top-level menu items.
    Dim menuItem1 As New MenuItem("&File")
    Dim menuItem2 As New MenuItem("&New")
    Dim menuItem3 As New 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)
End Sub

public void CreateMyMenus()
{
   // Create three top-level menu items.
   MenuItem menuItem1 = new MenuItem("&File");
   MenuItem menuItem2 = new MenuItem("&New");
   MenuItem menuItem3 = new 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);
}

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 );
   }

public void CreateMyMenus()
{
    // Create three top-level menu items.
    MenuItem menuItem1 = new MenuItem("&File");
    MenuItem menuItem2 = new MenuItem("&New");
    MenuItem menuItem3 = new MenuItem("&Open");

    // Set the BarBreak property to display horizontally.
    menuItem2.set_BarBreak(true);
    menuItem3.set_BarBreak(true);

    // Add menuItem2 and menuItem3 to the menuItem1's list of menu items.
    menuItem1.get_MenuItems().Add(menuItem2);
    menuItem1.get_MenuItems().Add(menuItem3);
} //CreateMyMenus

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MenuItem-Klasse
MenuItem-Member
System.Windows.Forms-Namespace
Break