如何：向 ToolBar 控件添加按钮

项目
08/18/2008

更新：2007 年 11 月

说明：
ToolStrip 控件替换了 ToolBar 控件并添加了功能；但是也可选择保留 ToolBar 控件以备向后兼容和将来使用。

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

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

以编程方式添加按钮

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

通过 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 控件添加按钮

以编程方式添加按钮

请参见

任务

参考

其他资源

其他资源