tutorial: agregar una barra de herramientas a una ventana de herramientas

Artículo
05/18/2015

este tutorial muestra cómo agregar una barra de herramientas a una ventana de herramientas. Las barras de herramientas proporcionan acceso rápido a los comandos en la ventana de herramientas.

Una barra de herramientas es una franja horizontal o vertical que contiene los botones enlazados a comandos. La longitud de una barra de herramientas en una ventana de herramientas siempre es igual al ancho o el alto de la ventana de herramientas, dependiendo de dónde la barra de herramientas está acoplada.

Las barras de herramientas en ventanas de herramientas no se crean automáticamente el entorno de (IDE) desarrollo integrado. Deben agregarse mediante programación por el Paquete que crea la ventana de herramientas.

A diferencia de las barras de herramientas en el IDE, una barra de herramientas en una ventana de herramientas debería acoplarse y no se puede mover o personalizar. Si la ventana de herramientas VSPackage se escribe en código administrado, la barra de herramientas está acoplada siempre en el borde superior de la ventana. Sin embargo, si el Paquete está escrita en código umanaged, la barra de herramientas se puede acoplar en los bordes.

Para obtener más información sobre cómo agregar una barra de herramientas en el IDE, vea tutorial: Agregar una barra de herramientas en el IDE.

Requisitos previos

Para completar este tutorial, debe instalar Visual Studio 2010 SDK.

Nota
Para obtener más información sobre el SDK de Visual Studio, vea Información general de Visual Studio que extiende.Para averiguar cómo descargar el SDK de Visual Studio, vea Centro para desarrolladores de extensibilidad de Visual Studio en el sitio web de MSDN.

Ubicaciones de la plantilla de proyecto paquete de Visual Studio

La plantilla de proyecto paquete de Visual Studio está disponible en tres ubicaciones en el cuadro de diálogo de Nuevo proyecto :

En extensibilidad de Visual Basic. El idioma predeterminado del proyecto es Visual Basic.
En extensibilidad de C#. El lenguaje predeterminado del proyecto es C#.
En La otra extensibilidad de los tipos de proyecto. El lenguaje predeterminado del proyecto es C++.

Crear un Paquete de una ventana de herramientas

En esta sección se muestra cómo utilizar la plantilla de proyecto paquete de Visual Studio para crear una ventana de herramientas VSPackage que admite solo un comando de menú.

para crear el TWToolbar VSPackage

Cree un Paquete denominado TWbarra de herramientas. Para obtener más información, vea tutorial: Crear un comando de menú mediante la plantilla de paquete de Visual Studio.
Establezca el lenguaje de programación a Visual Basic o a Visual c#, y seleccione las opciones de Comando de menú y de ventana de herramientas .
En opciones de comando, establezca el nombre de comando a comando de TWTest, y el identificador de comando a cmdidTWTestCmd.
En opciones de la ventana de herramientas, establezca el nombre de la ventana a Ventana de herramientas de prueba, y el identificador de comando a cmdidTestTool.

crear una barra de herramientas para una ventana de herramientas

Para crear una barra de herramientas de la ventana de herramientas

TWToolbar.vsct abierto en el editor de texto.
en la sección de Symbols , en el nodo de GuidSymbol denominado “guidTWToolbarCmdSet”, declare una barra de herramientas y un grupo de la barra de herramientas, como sigue.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
En la parte superior de la sección de Commands , cree una sección de Menus .
```
<Menus></Menus>
```
La definición de la barra de herramientas se encuentra aquí porque el analizador de VSCT no distingue entre los menús y barras de herramientas en este nivel.
agregue un elemento de Menu a la sección de Menus para definir la barra de herramientas.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Las barras de herramientas no se pueden anidar como submenús. Por consiguiente, no tiene que asignarse a un elemento primario. Además, no tiene que establecer una prioridad, porque el usuario puede mover las barras de herramientas. Normalmente, la posición inicial de una barra de herramientas se define mediante programación, pero los cambios subsiguientes del usuario se conservan.
En la sección de Groups , después de la entrada de grupo existente, defina un grupo para contener los comandos de la barra de herramientas.
```
<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>
```
En la sección de Buttons , cambie el elemento primario del elemento existente de Button el grupo de la barra de herramientas para que la barra de herramientas se mostrará.
```
<Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTWTestCmd</CommandName>
    <ButtonText>TWTest Command</ButtonText>
  </Strings>
</Button>
```
de forma predeterminada, si una barra de herramientas no tiene ningún comando, no aparece.

Dado que la nueva barra de herramientas no se agrega automáticamente a la ventana de herramientas por Visual Studio IDE, la barra de herramientas se debe agregar mediante programación el paquete VSPackage propio. Esto se explica en la sección siguiente, “agregar una barra de herramientas de la ventana de herramientas”.

Agregar la barra de herramientas en la ventana de herramientas

Para agregar la barra de herramientas en la ventana de herramientas

En el proyecto de TWToolbar, abra PkgCmdID.vb o PkgCmdID.cs en el editor de texto.
Después de los id. existentes del comando en el archivo de PkgCmdID, agregue el identificador de comando siguiente
```
public const int TWToolbar = 0x1000;
```
MyToolWindow.vb abierto o MyToolWindow.cs en el editor de texto.
En la parte superior del archivo, después del otro Imports o instrucciones de using , agregue la línea siguiente.
```
using System.ComponentModel.Design; // for CommandID
```
En el constructor de clase de MyToolWindow , al principio del constructor, agregue la línea siguiente.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Este código indica a (MPF) managed package qué barra de herramientas para crear cuando se crea la ventana de herramientas.

Nota

En código administrado, sólo una barra de herramientas se puede agregar a una ventana de herramientas.
Para compilar la solución, en el menú Compilar, haga clic en Compilar solución.

Nota
En código administrado, sólo una barra de herramientas se puede agregar a una ventana de herramientas.

Probar la barra de herramientas de la ventana de herramientas

Para probar la barra de herramientas de la ventana de herramientas

Presione F5 para abrir una instancia de Visual Studio experimental en modo de depuración.
En el menú de Ver , elija Otras ventanas y haga clic en Ventana de herramientas de prueba para mostrar la ventana de herramientas.

Observe que una barra de herramientas se muestra bajo el título de la ventana de herramientas.
En la barra de herramientas de la ventana de herramientas, haga clic en el icono para mostrar el mensaje “Company.TWToolbar.TW dentro ToolbarPackage.MenuItemCallback()”.

Vea también

Tareas

tutorial: Agregar una barra de herramientas en el IDE

Otros recursos

Tutoriales para los comandos, menús, barras de herramientas y

comandos, menús, y barras de herramientas

Compartir a través de