Практическое руководство. Добавление кнопок в элемент управления ToolBar

Обновлен: Ноябрь 2007

Примечание.
Элемент управления ToolStrip заменяет элемент управления ToolBar и расширяет его функциональные возможности; однако при необходимости элемент управления ToolBar можно сохранить для обратной совместимости и использования в будущем.

Неотъемлемой частью элемента управления ToolBar являются добавленные в него кнопки. Эти кнопки используются для предоставления легкого доступа к командам меню, также их можно разместить в другой области пользовательского интерфейса приложения для представления пользователям команд, недоступных в структуре меню.

В примере, представленном ниже, подразумевается, что элемент управления ToolBar добавлен в форму Windows Forms (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

Ссылки

ToolBar

Общие сведения об элементе управления ToolBar (Windows Forms)

Другие ресурсы

Элемент управления ToolBar (Windows Forms)