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

Actualización: noviembre 2007

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

Si los formularios Windows Forms presentan controles ToolBar con botones de la barra de herramientas, deseará saber en qué botón ha hecho clic el usuario.

En el evento ButtonClick del control ToolBar, puede evaluar la propiedad Button de la clase ToolBarButtonClickEventArgs. En el ejemplo siguiente, se muestra un cuadro de mensajes, que indica en qué botón se ha hecho clic. Para obtener información más detallada, vea MessageBox (Clase).

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

Para administrar el evento Click en la barra de herramientas

1. En un procedimiento, agregue botones de la barra de herramientas al control ToolBar.

   Public Sub ToolBarConfig()
   ' Instantiate the toolbar buttons, set their Text properties
   ' and add them to the ToolBar control.
      ToolBar1.Buttons.Add(New ToolBarButton("One"))
      ToolBar1.Buttons.Add(New ToolBarButton("Two"))
      ToolBar1.Buttons.Add(New ToolBarButton("Three"))
   ' Add the event handler delegate.
      AddHandler ToolBar1.ButtonClick, AddressOf Me.ToolBar1_ButtonClick
   End Sub
   

   public void ToolBarConfig() 
   {
      toolBar1.Buttons.Add(new ToolBarButton("One"));
      toolBar1.Buttons.Add(new ToolBarButton("Two"));
      toolBar1.Buttons.Add(new ToolBarButton("Three"));
   
      toolBar1.ButtonClick += 
         new ToolBarButtonClickEventHandler(this.toolBar1_ButtonClick);
   }
   

   public void ToolBarConfig() 
   {
      toolBar1.get_Buttons().Add(new ToolBarButton("One"));
      toolBar1.get_Buttons().Add(new ToolBarButton("Two"));
      toolBar1.get_Buttons().Add(new ToolBarButton("Three"));
   
      toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler(this.toolBar1_ButtonClick));
   }
   

   public:
      void ToolBarConfig()
      {
         toolBar1->Buttons->Add(gcnew ToolBarButton("One"));
         toolBar1->Buttons->Add(gcnew ToolBarButton("Two"));
         toolBar1->Buttons->Add(gcnew ToolBarButton("Three"));
   
         toolBar1->ButtonClick += 
            gcnew ToolBarButtonClickEventHandler(this,
            &Form1::toolBar1_ButtonClick);
      }
   

2. Agregue un controlador de eventos para el evento ButtonClick del control ToolBar. Utilice una instrucción de cambio de mayúsculas y minúsculas, y la clase ToolBarButtonClickEventArgs para determinar en qué botón de la barra de herramientas se ha hecho clic. Basándose en esto, muestre el cuadro de mensajes adecuado.

   Nota:
   El cuadro de mensajes de este ejemplo sólo se utiliza como un marcador de posición. Agregue el código que desee que se ejecute cuando se haga clic en los botones de la barra de herramientas.

   Protected Sub ToolBar1_ButtonClick(ByVal sender As Object, _
   ByVal e As ToolBarButtonClickEventArgs)
   ' Evaluate the Button property of the ToolBarButtonClickEventArgs
   ' to determine which button was clicked.
      Select Case ToolBar1.Buttons.IndexOf(e.Button)
        Case 0
          MessageBox.Show("First toolbar button clicked")
        Case 1
          MessageBox.Show("Second toolbar button clicked")
        Case 2
          MessageBox.Show("Third toolbar button clicked")
      End Select
   End Sub
   

   protected void toolBar1_ButtonClick(object sender,
   ToolBarButtonClickEventArgs e)
   {
      // Evaluate the Button property of the ToolBarButtonClickEventArgs
      // to determine which button was clicked.
      switch (toolBar1.Buttons.IndexOf(e.Button))
      {
         case 0 :
            MessageBox.Show("First toolbar button clicked");
            break;
         case 1 :
            MessageBox.Show("Second toolbar button clicked");
            break;
         case 2 :
            MessageBox.Show("Third toolbar button clicked");
            break;
      }
   }
   

   protected void toolBar1_ButtonClick(System.Object sender, ToolBarButtonClickEventArgs e) 
   {
      // Evaluate the Button property of the ToolBarButtonClickEventArgs
      // to determine which button was clicked.
      switch(toolBar1.get_Buttons().IndexOf(e.get_Button())) 
      {
         case 0 : 
            MessageBox.Show("First toolbar button clicked");
            break;
         case 1 : 
            MessageBox.Show("Second toolbar button clicked");
            break;
         case 2 : 
            MessageBox.Show("Third toolbar button clicked");
            break;
      }
   }
   

   protected:
      void toolBar1_ButtonClick(System::Object ^ sender,
         ToolBarButtonClickEventArgs ^ e)
      {
        // Evaluate the Button property of the ToolBarButtonClickEventArgs
        // to determine which button was clicked.
         switch (toolBar1->Buttons->IndexOf(e->Button))
         {
            case 0 :
               MessageBox::Show("First toolbar button clicked");
               break;
            case 1 :
               MessageBox::Show("Second toolbar button clicked");
               break;
            case 2 :
               MessageBox::Show("Third toolbar button clicked");
               break;
         }
      }
   

Vea también

Tareas

Cómo: Agregar botones a un control ToolBar

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

Referencia

ToolBar

Otros recursos

Barra de herramientas (Control, formularios Windows Forms)