Como: Adicionar botões a um controle de barra de ferramentas

Observação
O ToolStrip controle substitui e adiciona funcionalidade para o ToolBar controle; No entanto, o ToolBar controle é mantido para compatibilidade com versões anteriores e o uso futuro, se você escolher.

Parte integrante do ToolBar o controle é os botões que você adicionar ao proprietário. Eles podem ser usados para fornecer acesso fácil aos comandos de menu ou, Alternativamente, pode ser colocados em outra área da interface do usuário do seu aplicativo para expor comandos para os usuários que não estão disponíveis na estrutura de menu.

Os exemplos a seguir pressupõem que uma ToolBar controle tiver sido adicionado a um formulário do Windows (Form1).

Para adicionar botões de forma programática

1. Em um procedimento, crie botões da barra de ferramentas, adicionando-os para o ToolBar.Buttons coleção.

2. Especificar configurações de propriedade de um botão individual, passando o índice do botão via o Buttons propriedade.

   O exemplo a seguir supõe um formulário com um ToolBar controle já adicionado.

   Observação
   O ToolBar.Buttons coleção é uma coleção com base em zero, para que o código deve prosseguir adequadamente.

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

Consulte também

Tarefas

Como: Definir um ícone para um botão da barra de ferramentas

Como: Eventos disparadores de Menu para botões da barra de ferramentas

Referência

ToolBar

Visão geral sobre o controle de barra de ferramentas (Windows Forms)

Outros recursos

Barra de ferramentas controle (Windows Forms)