Share via

Vorgehensweise: Hinzufügen von Schaltflächen zu einem ToolBar-Steuerelement

  • Artikel

Hinweis

Obwohl das ToolStrip-Steuerelement das ToolBar-Steuerelement ersetzt und funktionell erweitert, wird das ToolBar-Steuerelement sowohl aus Gründen der Abwärtskompatibilität als auch, falls gewünscht, für die zukünftige Verwendung beibehalten.

Ein integraler Bestandteil des ToolBar-Steuerelements sind die Schaltflächen, die Sie hinzufügen. Diese können verwendet werden, um einfachen Zugriff auf Menübefehle zu bieten. Alternativ können sie in einem anderen Bereich der Benutzeroberfläche Ihrer Anwendung platziert werden, um Befehle für Benutzer*innen verfügbar zu machen, die in der Menüstruktur nicht verfügbar sind.

In den folgenden Beispielen wird davon ausgegangen, dass einem Windows Formular (Form1) ein ToolBar-Steuerelement hinzugefügt wurde.

So fügen Sie Schaltflächen programmgesteuert hinzu

  1. Erstellen Sie in einer Prozedur Symbolleistenschaltflächen, indem Sie sie der ToolBar.Buttons-Auflistung hinzufügen.

  2. Geben Sie Eigenschafteneinstellungen für eine einzelne Schaltfläche an, indem Sie den Index der Schaltfläche über die Buttons-Eigenschaft übergeben.

    Im folgenden Beispiel wird ein Formular vorausgesetzt, dem bereits ein ToolBar-Steuerelement hinzugefügt wurde.

    Hinweis

    Die ToolBar.Buttons-Auflistung ist eine nullbasierte Auflistung, sodass Code entsprechend fortfahren sollte.

    Public Sub CreateToolBarButtons()  
' Create buttons and set text property.  
   ToolBar1.Buttons.Add("One")  
   ToolBar1.Buttons.Add("Two")  
   ToolBar1.Buttons.Add("Three")  
   ToolBar1.Buttons.Add("Four")  
' Set properties of StatusBar panels.  
' Set Style property.  
   ToolBar1.Buttons(0).Style = ToolBarButtonStyle.PushButton  
   ToolBar1.Buttons(1).Style = ToolBarButtonStyle.Separator  
   ToolBar1.Buttons(2).Style = ToolBarButtonStyle.ToggleButton  
   ToolBar1.Buttons(3).Style = ToolBarButtonStyle.DropDownButton  
' Set the ToggleButton's PartialPush property.  
   ToolBar1.Buttons(2).PartialPush = True  
' Instantiate a ContextMenu component and menu items.  
' Set the DropDownButton's DropDownMenu property to the context menu.  
   Dim cm As New ContextMenu()  
   Dim miOne As New MenuItem("One")  
   Dim miTwo As New MenuItem("Two")  
   Dim miThree As New MenuItem("Three")  
   cm.MenuItems.Add(miOne)  
   cm.MenuItems.Add(miTwo)  
   cm.MenuItems.Add(miThree)  
   ToolBar1.Buttons(3).DropDownMenu = cm  
' Set the PushButton's Pushed property.  
   ToolBar1.Buttons(0).Pushed = True  
' Set the ToolTipText property of one of the buttons.  
   ToolBar1.Buttons(1).ToolTipText = "Button 2"  
End Sub  

    public void CreateToolBarButtons()  
{  
   // Create buttons and set text property.  
   toolBar1.Buttons.Add("One");  
   toolBar1.Buttons.Add("Two");  
   toolBar1.Buttons.Add("Three");  
   toolBar1.Buttons.Add("Four");  

   // Set properties of StatusBar panels.  
   // Set Style property.  
   toolBar1.Buttons[0].Style = ToolBarButtonStyle.PushButton;  
   toolBar1.Buttons[1].Style = ToolBarButtonStyle.Separator;  
   toolBar1.Buttons[2].Style = ToolBarButtonStyle.ToggleButton;  
   toolBar1.Buttons[3].Style = ToolBarButtonStyle.DropDownButton;  

   // Set the ToggleButton's PartialPush property.  
   toolBar1.Buttons[2].PartialPush = true;  

   // Instantiate a ContextMenu component and menu items.  
   // Set the DropDownButton's DropDownMenu property to
   // the context menu.  
   ContextMenu cm = new ContextMenu();  
   MenuItem miOne = new MenuItem("One");  
   MenuItem miTwo = new MenuItem("Two");  
   MenuItem miThree = new MenuItem("Three");  
   cm.MenuItems.Add(miOne);  
   cm.MenuItems.Add(miTwo);  
   cm.MenuItems.Add(miThree);  

   toolBar1.Buttons[3].DropDownMenu = cm;  
   // Set the PushButton's Pushed property.  
   toolBar1.Buttons[0].Pushed = true;  
   // Set the ToolTipText property of 1 of the buttons.  
   toolBar1.Buttons[1].ToolTipText = "Button 2";  
}  

    public:  
   void CreateToolBarButtons()  
   {  
      // Create buttons and set text property.  
      toolBar1->Buttons->Add( "One" );  
      toolBar1->Buttons->Add( "Two" );  
      toolBar1->Buttons->Add( "Three" );  
      toolBar1->Buttons->Add( "Four" );  

      // Set properties of StatusBar panels.  
      // Set Style property.  
      toolBar1->Buttons[0]->Style = ToolBarButtonStyle::PushButton;  
      toolBar1->Buttons[1]->Style = ToolBarButtonStyle::Separator;  
      toolBar1->Buttons[2]->Style = ToolBarButtonStyle::ToggleButton;  
      toolBar1->Buttons[3]->Style = ToolBarButtonStyle::DropDownButton;  

      // Set the ToggleButton's PartialPush property.  
      toolBar1->Buttons[2]->PartialPush = true;  

      // Instantiate a ContextMenu component and menu items.  
      // Set the DropDownButton's DropDownMenu property to
      // the context menu.  
      System::Windows::Forms::ContextMenu^ cm = gcnew System::Windows::Forms::ContextMenu;  
      MenuItem^ miOne = gcnew MenuItem( "One" );  
      MenuItem^ miTwo = gcnew MenuItem( "Two" );  
      MenuItem^ miThree = gcnew MenuItem( "Three" );  
      cm->MenuItems->Add( miOne );  
      cm->MenuItems->Add( miTwo );  
      cm->MenuItems->Add( miThree );  
      toolBar1->Buttons[3]->DropDownMenu = cm;  

      // Set the PushButton's Pushed property.  
      toolBar1->Buttons[0]->Pushed = true;  

      // Set the ToolTipText property of 1 of the buttons.  
      toolBar1->Buttons[1]->ToolTipText = "Button 2";  
   }

Weitere Informationen