Cómo: Cree las barras de herramientas en el IDE

Artículo
05/18/2015

Puede agregar una barra de herramientas al (IDE) IDE definiendo un menú de Toolbar escrito en un archivo de Paquete .vsct.

una barra de herramientas tiene las siguientes características:

Una barra de herramientas es una horizontal o una barra vertical que contienen botones. los botones pueden tener un icono o un texto, o una combinación de icono y de texto.
Una barra de herramientas se puede acoplar en los bordes de la ventana primaria.
El IDE trata una barra de herramientas VSPackage-contribuida como ella trata las barras de herramientas incluidas en Visual Studio. El Paquete no tiene que hacer nada habilitar mediante programación la barra de herramientas que se reconocerá por el cuadro de diálogo de Personalizar . Si un usuario personaliza la barra de herramientas, el IDE sigue automáticamente los cambios.
El IDE automáticamente permite a la barra de herramientas para aparecer en el submenú de barras de herramientas de menú de Ver de modo que los usuarios puedan ocultarlos o mostrarlos.
una barra de herramientas que no tiene un comando visible automáticamente se oculta.

Puede cambiar estas características especificando mensajes cuando se define la barra de herramientas en el archivo de .vsct, como se muestra en el procedimiento siguiente.

Para crear una barra de herramientas del IDE

Crear un paquete ejecutando la plantilla paquete de Visual Studio. Siga las instrucciones de la paquetes en tutorial: Agregar una barra de herramientas en el IDE.
Abra el archivo de .vsct en el editor. En la sección formada por la sección de Símbolos , busque el elemento de GuidSymbol que contiene los menús, los grupos, y los comandos.
Como se muestra en el ejemplo siguiente, agregue un elemento de IDSymbol para cada uno de ellos: una barra de herramientas, un grupo de comandos, y uno o varios comandos.
```
<IDSymbol name="MyMenuGroup" value="0x1020" />
<IDSymbol name="cmdidTestCmd" value="0x0100" />
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" 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 la sección de Grupos , cree una sección de menús .
defina la barra de herramientas como elemento de Menú 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 priority (opcional).
  
  El atributo de priority se omite normalmente de una barra de herramientas porque puede desplazarse por los usuarios. La omisión del atributo de priority tiene el mismo efecto que estableciéndolo en 0. Sin embargo, si la misma ventana tiene varias barras de herramientas, puede asignar sus posiciones inicial estableciendo sus prioridades.
3. establezca el atributo de type a barra de herramientas.
4. En el elemento de Menu , utilice el elemento de Cadenas crear una sección que contiene un elemento de ButtonText y un elemento de CommandName . 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.
  
  Si desea agregar marcadores de comando, agregue un elemento de CommandFlag para cada uno.
  
  Para las descripciones de los valores de indicador de comando, vea CommandFlag (Elemento).
El ejemplo siguiente se define una barra de herramientas.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Nota

No tiene que definir un elemento primario de un menú de Toolbar tipo porque automáticamente se coloca en el IDE.cualquier valor para el elemento primario se omite.
En la sección formada por la sección de Grupos , cree un elemento de Agrupar 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.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Agregue los comandos a la barra de herramientas crear entradas de comando en la sección formada por la sección de Botones . Establezca el elemento primario de cada entrada de comando a GUID: Identificador del grupo. cada elemento de Botn debe tener GUID: Identificador que corresponde a una entrada de la sección de Symbols .

Utilice el atributo de priority de cada entrada del botón para especificar que el comando aparecerá en el grupo.

El ejemplo siguiente define un botón que aparece en la barra de herramientas.
```
<Button guid="guidIDEToolbarCmdSet" id="cmdidTestCmd" priority="0x0100" type="Button">
  <Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTestCmd</CommandName>
    <ButtonText>Toolbar Test Command</ButtonText>
  </Strings>
</Button>
```
Para obtener más información sobre los botones y elementos de menú, vea Button (Elemento).

Nota
No tiene que definir un elemento primario de un menú de Toolbar tipo porque automáticamente se coloca en el IDE.cualquier valor para el elemento primario se omite.