Partilhar via

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

  • Artigo

Observação

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

Uma parte integrante do controle ToolBar são os botões que você adiciona a ele. Eles podem ser usados para fornecer acesso fácil a comandos de menu ou, alternativamente, podem ser colocados em outra área da interface do usuário do seu aplicativo para expor comandos aos usuários que não estão disponíveis na estrutura do menu.

Os exemplos abaixo pressupõem que um controle ToolBar foi adicionado a um Windows Form (Form1).

Para adicionar botões programaticamente

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

  2. Especifique definições de propriedade para um botão individual fornecendo o índice do botão através da propriedade Buttons.

    O exemplo abaixo assume um formulário com um controle ToolBar já adicionado.

    Observação

    A coleção ToolBar.Buttons é uma coleção baseada em zero, portanto, o código deve prosseguir de acordo.

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

Ver também