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

ToolBar (Clase)

Actualización: noviembre 2007

Representa una barra de herramientas de Windows. Aunque el control ToolStrip reemplaza y agrega funcionalidad al control ToolBar de versiones anteriores, se conserva ToolBar 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)

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class ToolBar : Control
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class ToolBar extends Control
public class ToolBar extends Control

Los controles ToolBar se utilizan para mostrar los controles ToolBarButton que pueden aparecer como un botón estándar, un botón de alternar o un botón desplegable. Se pueden asignar imágenes a los botones creando un ImageList, asignándolo a la propiedad ImageList de la barra de herramientas y asignando el valor de índice de la imagen a la propiedad ImageIndex para cada ToolBarButton. A continuación, se puede asignar texto que aparecerá debajo o a la derecha de la imagen estableciendo la propiedad Text de ToolBarButton.

Establezca la propiedad Appearance de la barra de herramientas en Flat para dar un aspecto sin relieve a la barra de herramientas y a sus botones. A medida que el puntero del mouse (ratón) se desplaza por los botones, su apariencia cambia a tridimensional. Los botones de la barra de herramientas pueden dividirse en grupos lógicos mediante separadores. Un separador es un botón de la barra de herramientas con la propiedad Style establecida en ToolBarButtonStyle.Separator. Los separadores de botones aparecen como líneas en lugar de espacios entre los botones cuando la barra de herramientas tiene un aspecto sin relieve. Si la propiedad Appearance está establecida en Normal, los botones de la barra de herramientas aparecen elevados y con aspecto tridimensional.

Si se especifica un valor para la propiedad ButtonSize, todos los botones de la barra de herramientas se restringen al tamaño especificado. En caso contrario, el tamaño de los botones se ajusta en función de su contenido y la propiedad ButtonSize devuelve el tamaño inicial del botón más grande.

Para crear una colección de controles ToolBarButton que aparecerán en ToolBar, agregue los botones individualmente mediante los métodos Add o Insert de la propiedad Buttons.

Nota de la plataforma Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows CE:

Un formulario admite sólo un control ToolBar; los intentos de agregar otro control ToolBar producen una excepción NotSupportedException. No se admite agregar un control ToolBar a ningún otro control que no sea un formulario, como un control Panel.

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. Este código 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; 
    }
 }



Todos los miembros static (Shared en Visual Basic) públicos 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0
Mostrar: