如何:向 ToolBar 控件添加按钮

提示

ToolStrip 控件取代了 ToolBar 控件并添加了功能;但是,可以选择保留 ToolBar 控件以实现向后兼容并供将来使用。

ToolBar 控件中添加的按钮是该控件的必要组成部分。 使用这些按钮可以很容易地访问菜单命令;或者也可以将它们放在应用程序用户界面的另一个区域,向用户公开菜单结构中不可用的命令。

下面的示例假定已经将 ToolBar 控件添加到 Windows 窗体 (Form1) 中。

以编程方式添加按钮

  1. 在过程中,创建工具栏按钮,方法是将这些按钮添加到 ToolBar.Buttons 集合中。

  2. 通过 Buttons 属性传递按钮的索引来指定单个按钮的属性设置。

    下面的示例假定一个已添加了 ToolBar 控件的窗体。

    提示

    ToolBar.Buttons 集合是一个从零开始的集合,因此,编写代码时应使用相应的初始值。

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

请参见

任务

如何:定义工具栏按钮的图标

如何:触发工具栏按钮的菜单事件

参考

ToolBar

ToolBar 控件概述(Windows 窗体)

其他资源

ToolBar 控件(Windows 窗体)