Esta documentación está archivada y no tiene mantenimiento.

ToolBarButton (Clase)

Representa un botón de barra de herramientas de Windows. Aunque ToolStripButton reemplaza y amplía el control ToolBarButton de versiones anteriores, se conserva ToolBarButton a efectos de compatibilidad con versiones anteriores y uso futuro, en su caso.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class ToolBarButton : Component
public class ToolBarButton extends Component
public class ToolBarButton extends Component
No aplicable.

Los controles ToolBarButton están relacionados por controles ToolBar. Las propiedades comunes que se van a establecer una vez que se ha creado el botón de barra de herramientas son Text y ImageIndex. Establezca la propiedad Text 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 un objeto ImageList, asígnelo a la propiedad ImageList de la barra de herramientas y, a continuación, asigne el valor de índice de imagen a la propiedad ImageIndex del botón.

Para cambiar la apariencia de los botones de barra de herramientas asignados a la barra de herramientas, establezca la propiedad Appearance del control de barra de herramientas primario. La apariencia ToolBarAppearance.Flat proporciona a los botones una apariencia sin relieve. A medida que el puntero del mouse (ratón) se desplaza por los botones, su apariencia cambia a tridimensional. Los separadores de botones aparecen como líneas en lugar de espacios entre los botones cuando los botones tienen una apariencia sin relieve. Si la propiedad Appearance está establecida en ToolBarAppearance.Normal, los botones tendrán una apariencia tridimensional elevada y los separadores tendrán la apariencia de un espacio entre los botones.

Se puede asignar un objeto ContextMenu a un botón si la propiedad Style está establecida en ToolBarButtonStyle.DropDown. Al hacer clic en el botón, se mostrará el menú asignado.

Para crear una colección de controles ToolBarButton que se muestren en ToolBar, agregue los botones de forma individual mediante el uso del método Add de la propiedad Buttons. Otra opción consiste en agregar varios botones de barra de herramientas utilizando el método AddRange.

En el siguiente ejemplo de código se crea un ToolBar y tres controles ToolBarButton. Los botones de barra de herramientas se asignan a la colección de botones, la colección se asigna a la barra de herramientas y ésta se agrega al formulario. En el evento ButtonClick de la barra de herramientas, se evalúa la propiedad Button de ToolBarButtonClickEventArgs y se abre el cuadro de diálogo correspondiente. En este código se requiere que se haya creado un Form, un OpenFileDialog, un SaveFileDialog y un PrintDialog.

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


System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.Windows.Forms.ToolBarButton

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: