Cómo: Agregar botones a un control ToolBar

Actualización: noviembre 2007

Nota:
Aunque el control ToolStrip viene a reemplazar y a agregar funcionalidad al control ToolBar, este control ToolBar se conserva a efectos de compatibilidad con versiones anteriores y para uso futuro, según sea el caso.

Una parte integral del control ToolBar la constituyen los botones que se le agregan. Estos botones se pueden utilizar para proporcionar acceso sencillo a comandos de menú o, de forma alternativa, pueden incluirse en otra área de la interfaz de usuario de la aplicación para exponer comandos a los usuarios que no están disponibles en la estructura de menús.

En el ejemplo siguiente se supone que se ha agregado un control ToolBar a un formulario Windows Forms (Form1).

Para agregar botones mediante programación

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

2. Especifique valores de propiedad de un botón individual pasando el índice del botón por medio de la propiedad Buttons.

   En el ejemplo siguiente suponemos que ya se ha agregado un control ToolBar al formulario.

   Nota:
   La colección ToolBar.Buttons es una colección de base cero, de modo que el código debe proceder 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";
      }
   

Vea también

Tareas

Cómo: Definir un icono para un botón ToolBar

Cómo: Desencadenar eventos de menú para los botones de la barra de herramientas

Referencia

ToolBar

Información general del control ToolBar (formularios Windows Forms)

Otros recursos

Barra de herramientas (Control, formularios Windows Forms)