Compartir a través de

Procedimiento para agregar botones a un control de la barra de herramientas

  • Artículo

Nota:

El control ToolStrip reemplaza y agrega funcionalidad al control ToolBar; sin embargo, el control ToolBar se conserva a efectos de compatibilidad con versiones anteriores y uso futuro, en su caso.

Una parte integral del control ToolBar son los botones que se le agregan. Se pueden usar para proporcionar un acceso sencillo a los comandos de menú o, como alternativa, se pueden colocar en otra área de la interfaz de usuario de la aplicación para exponer a los usuarios comandos que no están disponibles en la estructura de menús.

En los ejemplos siguientes se da por supuesto que se ha agregado un control ToolBar a un formulario de Windows Forms (Form1).

Para agregar botones mediante programación

  1. En un procedimiento, cree botones de barra de herramientas agregándolos a la colección ToolBar.Buttons.

  2. Para especificar la configuración de propiedad de un botón individual, pase el índice del botón mediante la propiedad Buttons.

    En el ejemplo siguiente se da por supuesto que hay un formulario con un control ToolBar ya agregado.

    Nota:

    La colección ToolBar.Buttons es de base cero, por lo que el código debe actuar en consecuencia.

    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 también