Cómo: Crear barras de herramientas para las ventanas de herramientas

Artículo
05/18/2015

Puede agregar una barra de herramientas a una ventana de herramientas definiendo un menú de ToolWindowToolbar escrito en un archivo de Paquete .vsct, y después programando el paquete para mostrarlo.

Las barras de herramientas en ventanas de herramientas difieren de las barras de herramientas en el entorno de desarrollo integrado general (IDE) de las maneras siguientes:

Una barra de herramientas del IDE puede crear simplemente definiendo un menú de Toolbar escrito en el archivo de .vsct. Una barra de herramientas de la ventana de herramientas se debe crear mediante programación en la ventana de herramientas de destino.
Un usuario puede configurar una barra de herramientas del IDE mediante el cuadro de diálogo Personalizar . Una barra de herramientas de la ventana de herramientas no se puede configurar de esta manera.

crear una barra de herramientas de la ventana de herramientas

Una barra de herramientas de la ventana de herramientas es primero definido como Menu (Elemento) en el archivo de .vsct.

Los procedimientos siguientes se supone que tiene un proyecto de Paquete en el que una ventana de herramientas está definido en el archivo de .vsct. Si está creando un VSPackage, en el asistente del paquete, ventana de herramientas seleccione para agregar un archivo de .vsct el proyecto paquete y definir una ventana de herramientas.

para crear una barra de herramientas de la ventana de herramientas

Abra el archivo de .vsct en el editor.
Busque la sección formada por Symbols (Elemento).
Busque GuidSymbol (Elemento) que contiene los menús, los grupos, y los comandos. de forma predeterminada, se denomina guid <ProjectName> CmdSet.
Agregue IDSymbol (Elemento) para la barra de herramientas, y otro para que un grupo contiene los comandos, como se muestra en el ejemplo siguiente.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
los atributos de name de los elementos de GuidSymbol y de IDSymbol en una barra de herramientas, un comando, o un grupo definido proporcionan GUID: Par del identificador que representa la barra de herramientas, comando, o grupo. GUID representa un comando establecido que está definido para el Paquete. Varios conjuntos de comandos pueden estar definidos en el paquete. GUID: Los pares de identificador que se utilizan para identificar cada elemento deben ser únicos.
Justo encima de la sección formada por Groups (Elemento), cree una sección utilizando Menus (Elemento).
defina la barra de herramientas como Menu (Elemento) en la sección de Menus , como sigue:
1. establezca los atributos de guid y de id a GUID: identificador de la nueva barra de herramientas.
2. establezca el atributo de type a ToolWindowToolbar.
3. En el elemento de Menu , utilice Strings (Elemento) crear una sección que contiene ButtonText (Elemento) y CommandName (Elemento). El elemento de ButtonText se utiliza para establecer el nombre de la barra de herramientas que aparece en el IDE. El elemento de CommandName se utiliza para establecer el nombre de comando que se puede escribir en la ventana de comandos para tener acceso a la barra de herramientas.
El ejemplo siguiente se define una barra de herramientas de la ventana de herramientas.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
En la sección de Groups , cree Group (Elemento) para contener los comandos que desea mostrar en la barra de herramientas.
1. Establezca la prioridad del grupo para determinar dónde aparecerá en la barra de herramientas.
  
  Un grupo que tiene un envío de prioridad baja aparecerá en el lado izquierdo de la barra de herramientas (o superior, dependiendo de cómo se orienta la barra de herramientas).
2. Establezca el elemento primario del grupo a GUID: identificador de la barra de herramientas.
El grupo siguiente aparece en la barra de herramientas definido en el ejemplo anterior.
```
<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>
```

Mostrar la barra de herramientas de la ventana de herramientas

Utilice el (MPF) managed package programar el paquete para mostrar la barra de herramientas de la ventana de herramientas.

la propiedad de ToolBar de la clase de ToolWindowPane toma una instancia de CommandID como su valor. La instancia de CommandID toma a (cadena) Guid y (int) un identificador Establecer estos en GUID: El par de identificador de la barra de herramientas, la barra de herramientas se enlaza a la ventana de herramientas. Normalmente, esto se hace en el constructor de la clase que deriva de la clase de ToolWindowPane .

Una ventana de herramientas de código administrado que se compila utilizando el MPF sólo puede tener una barra de herramientas.

Para mostrar la barra de herramientas de la ventana de herramientas

Cuando se crea un Paquete mediante el asistente del paquete, agregue el comando GUID determinado automáticamente a la clase de GuidList , que se define en el archivo de Guids.cs. Los id. generados de menú y el comando se agregan a la clase de PkgCmdIDList , que se define en PkgCmdID.cs. A continuación, el GUID y los valores de identificador se puede tener acceso, en un formato legible, a través de las dos clases.

PkgCmdID.cs abierto.
Agregue una entrada para la barra de herramientas de la ventana de herramientas, y para cualquier comando que desea mostrar en la barra de herramientas. El valor de cada entrada debe coincidir con el atributo de value de elemento asociado de IDSymbol .

El ejemplo siguiente se crea una entrada para el anterior definido de la barra de herramientas.
```
public const int TWToolbar = 0x1000;
```
MyToolWindow.cs abierto.
En el constructor, establezca la propiedad de ToolBar de la clase de MyToolWindow a una nueva instancia de CommandID con Guid y el identificador de la barra de herramientas como parámetros, como se muestra en el ejemplo siguiente.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Si las clases de GuidList y de PkgCmdIDList no son definido, puede utilizar el valor de String de GUID y el valor de Int ID en su lugar.