ToolBarButton Clase

Definición

public ref class ToolBarButton : System::ComponentModel::Component

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Herencia

Object

MarshalByRefObject

Component

ToolBarButton

Ejemplos

En el ejemplo de código siguiente se crean tres ToolBar controles y ToolBarButton . Los botones de la barra de herramientas se asignan a la colección de botones, la colección se asigna a la barra de herramientas y la barra de herramientas se agrega al formulario. En el ButtonClick evento de la barra de herramientas, la Button propiedad de ToolBarButtonClickEventArgs se evalúa y se abre el cuadro de diálogo adecuado. Este código requiere que se hayan creado todos los Formelementos , OpenFileDialogSaveFileDialogy PrintDialog .

public:
   void InitializeMyToolBar()
   {
      // Create and initialize the ToolBar and ToolBarButton controls.
      toolBar1 = gcnew ToolBar;
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
      
      // Set the Text properties of the ToolBarButton controls.
      toolBarButton1->Text = "Open";
      toolBarButton2->Text = "Save";
      toolBarButton3->Text = "Print";
      
      // Add the ToolBarButton controls to the ToolBar.
      toolBar1->Buttons->Add( toolBarButton1 );
      toolBar1->Buttons->Add( toolBarButton2 );
      toolBar1->Buttons->Add( toolBarButton3 );
      
      // Add the event-handler delegate.
      toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler(
         this, &Form1::toolBar1_ButtonClick );
      
      // Add the ToolBar to the Form.
      Controls->Add( toolBar1 );
   }

private:
   void toolBar1_ButtonClick(
      Object^ sender,
      ToolBarButtonClickEventArgs^ e )
   {
      // Evaluate the Button property to determine which button was clicked.
      switch ( toolBar1->Buttons->IndexOf( e->Button ) )
      {
         case 0:
            openFileDialog1->ShowDialog();
            // Insert code to open the file.
            break;
         case 1:
            saveFileDialog1->ShowDialog();
            // Insert code to save the file.
            break;
         case 2:
            printDialog1->ShowDialog();
            // Insert code to print the file.    
            break;
      }
   }

public void InitializeMyToolBar()
 {
    // Create and initialize the ToolBar and ToolBarButton controls.
    toolBar1 = new ToolBar();
    ToolBarButton toolBarButton1 = new ToolBarButton();
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
 
    // Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open";
    toolBarButton2.Text = "Save";
    toolBarButton3.Text = "Print";
 
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
    
    // Add the event-handler delegate.
    toolBar1.ButtonClick += new ToolBarButtonClickEventHandler (
       this.toolBar1_ButtonClick);
    
    // Add the ToolBar to the Form.
    Controls.Add(toolBar1);
 }
 
 private void toolBar1_ButtonClick (
                         Object sender, 
                         ToolBarButtonClickEventArgs e)
 {
   // Evaluate the Button property to determine which button was clicked.
   switch(toolBar1.Buttons.IndexOf(e.Button))
   {
      case 0:
         openFileDialog1.ShowDialog();
         // Insert code to open the file.
         break; 
      case 1:
         saveFileDialog1.ShowDialog();
         // Insert code to save the file.
         break; 
      case 2:
         printDialog1.ShowDialog();
         // Insert code to print the file.    
         break; 
    }
 }

Public Sub InitializeMyToolBar()
    ' Create and initialize the ToolBar and ToolBarButton controls.
    Dim toolBar1 As New ToolBar()
    Dim toolBarButton1 As New ToolBarButton()
    Dim toolBarButton2 As New ToolBarButton()
    Dim toolBarButton3 As New ToolBarButton()
    
    ' Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open"
    toolBarButton2.Text = "Save"
    toolBarButton3.Text = "Print"
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Add the event-handler delegate.
    AddHandler toolBar1.ButtonClick, AddressOf Me.toolBar1_ButtonClick
    
    ' Add the ToolBar to the Form.
    Controls.Add(toolBar1)
End Sub    

Private Sub toolBar1_ButtonClick(ByVal sender As Object, _
ByVal e As ToolBarButtonClickEventArgs)

    ' Evaluate the Button property to determine which button was clicked.
    Select Case toolBar1.Buttons.IndexOf(e.Button)
        Case 0
            openFileDialog1.ShowDialog()
            ' Insert code to open the file.
        Case 1
            saveFileDialog1.ShowDialog()
            ' Insert code to save the file.
        Case 2
            printDialog1.ShowDialog()
            ' Insert code to print the file.
    End Select
End Sub

Comentarios

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Utilice ToolStripButton en su lugar.

ToolBarButton los controles son primarios por ToolBar controles. Las propiedades comunes que se van a establecer una vez creado el botón de la barra de herramientas son Text y ImageIndex. Establezca la Text propiedad del botón para mostrar texto debajo o a la derecha de la imagen. Para asignar imágenes a los botones mediante la creación de , ImageListasígnela a la ImageList propiedad de la barra de herramientas; a continuación, asigne el valor de índice de imagen a la ImageIndex propiedad del botón.

Para cambiar la apariencia de los botones de la barra de herramientas asignados a la barra de herramientas, establezca la Appearance propiedad del control primario de la barra de herramientas. La ToolBarAppearance.Flat apariencia proporciona a los botones un aspecto plano. A medida que el puntero del mouse se mueve sobre los botones, su apariencia cambia a tridimensional. Los separadores de botón aparecen como líneas en lugar de espacios entre los botones cuando los botones tienen una apariencia plana. Si la Appearance propiedad se establece ToolBarAppearance.Normalen , los botones aparecen elevados y tridimensionales, y los separadores aparecen como un espacio entre los botones.

Puede asignar un ContextMenu a un botón si la Style propiedad está establecida en ToolBarButtonStyle.DropDown. Cuando se hace clic en el botón, se muestra el menú asignado.

Para crear una colección de ToolBarButton controles que se van a mostrar en , ToolBaragregue los botones individualmente mediante el Add método de la Buttons propiedad . Como alternativa, puede agregar varios botones de barra de herramientas mediante el AddRange método .

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• ToolBar
• MenuItem
• ImageList
• ToolTip