ToolStrip (Clase) (System.Windows.Forms)

Cambiar vista:
Sin script
Biblioteca de clases de .NET Framework
ToolStrip (Clase)

Actualización: noviembre 2007

Proporciona un contenedor para los objetos de barra de herramientas de Windows.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
Sintaxis

Visual Basic (Declaración)
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class ToolStrip _
	Inherits ScrollableControl _
	Implements IComponent, IDisposable
Visual Basic (Uso)
Dim instance As ToolStrip
C#
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class ToolStrip : ScrollableControl, IComponent, 
	IDisposable
Visual C++
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[ComVisibleAttribute(true)]
public ref class ToolStrip : public ScrollableControl, 
	IComponent, IDisposable
J#
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute ComVisibleAttribute(true) */
public class ToolStrip extends ScrollableControl implements IComponent, 
	IDisposable
JScript
public class ToolStrip extends ScrollableControl implements IComponent, IDisposable
Comentarios

ToolStrip es la clase base para MenuStrip, StatusStrip y ContextMenuStrip.

Utilice ToolStrip y sus clases asociadas en nuevas aplicaciones de Windows Forms para crear barras de herramientas que pueden tener una apariencia y un comportamiento de Windows XP, Office, Internet Explorer o personalizados, todas ellas con o sin temas, con posibilidad de desbordamiento y reordenación de elementos en tiempo de ejecución. Los controles ToolStrip también proporcionan una experiencia completa en tiempo de diseño que incluye la activación y edición en contexto, diseño personalizado, y uso compartido del espacio horizontal o vertical dentro de un ToolStripContainer especificado.

La clase ToolStrip proporciona muchos miembros que administran el dibujo y la entrada de datos mediante mouse (ratón) y teclado, además de la funcionalidad de arrastrar y colocar. Utilice la clase ToolStripRenderer con la clase ToolStripManager para tener aún más control y posibilidad de personalización del estilo de dibujo y de diseño de todos los controles ToolStrip en un formulario Windows Forms.

Los elementos siguientes están diseñados específicamente para trabajar sin problemas con ToolStripSystemRenderer y ToolStripProfessionalRenderer en todas las orientaciones. Están disponibles de forma predeterminada en tiempo de diseño para el control ToolStrip:

Puede unir controles ToolStrip en un ToolStripContainer especificado y combinar controles ToolStrip entre sí. Utilice ToolStripPanel en lugar de ToolStripContainer para las aplicaciones de interfaz de múltiples documentos (MDI). Normalmente, ToolStrip no participa en el orden de tabulación a menos que tenga una posición absoluta en lugar de estar acoplado o en un ToolStripPanel.

Utilice la clase ToolStripControlHost para alojar cualquier otro control de formularios Windows Forms en ToolStrip.

De forma predeterminada, ToolStrip se almacena en búfer doble, para lo que aprovecha la configuración de OptimizedDoubleBuffer.

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.

Ejemplos

En el ejemplo de código siguiente se muestra cómo agregar un ToolStripContainer y un ToolStrip a un formulario Windows Forms, cómo agregar elementos a ToolStrip y cómo agregar ToolStrip al TopToolStripPanel de ToolStripContainer.

Visual Basic
Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms




Public Class Form1
   Inherits Form
   Private toolStripContainer1 As ToolStripContainer
   Private toolStrip1 As ToolStrip


   Public Sub New()
      InitializeComponent()
   End Sub 'New

   <STAThread()>  _
   Shared Sub Main()
      Application.EnableVisualStyles()
      Application.Run(New Form1())
   End Sub 'Main


   Private Sub InitializeComponent()
      toolStripContainer1 = New System.Windows.Forms.ToolStripContainer()
      toolStrip1 = New System.Windows.Forms.ToolStrip()
      ' Add items to the ToolStrip.
      toolStrip1.Items.Add("One")
      toolStrip1.Items.Add("Two")
      toolStrip1.Items.Add("Three")
      ' Add the ToolStrip to the top panel of the ToolStripContainer.
      toolStripContainer1.TopToolStripPanel.Controls.Add(toolStrip1)
      ' Add the ToolStripContainer to the form.
      Controls.Add(toolStripContainer1)
   End Sub 'InitializeComponent 
End Class 'Form1


C#
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;


public class Form1 : Form
{
    private ToolStripContainer toolStripContainer1;
    private ToolStrip toolStrip1;

    public Form1()
    {
        InitializeComponent();
    }
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new Form1());
    }

    private void InitializeComponent()
    {
        toolStripContainer1 = new System.Windows.Forms.ToolStripContainer();
        toolStrip1 = new System.Windows.Forms.ToolStrip();
        // Add items to the ToolStrip.
        toolStrip1.Items.Add("One");
        toolStrip1.Items.Add("Two");
        toolStrip1.Items.Add("Three");
        // Add the ToolStrip to the top panel of the ToolStripContainer.
        toolStripContainer1.TopToolStripPanel.Controls.Add(toolStrip1);
        // Add the ToolStripContainer to the form.
        Controls.Add(toolStripContainer1);

    }
}


Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.ScrollableControl
          System.Windows.Forms.ToolStrip
            System.Windows.Forms.BindingNavigator
            System.Windows.Forms.MenuStrip
            System.Windows.Forms.StatusStrip
            System.Windows.Forms.ToolStripDropDown
Seguridad para subprocesos

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.
Plataformas

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

.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.
Información de versión

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Vea también

Referencia

Otros recursos