Přidání panelu nástrojů do okna nástroje

Tento názorný postup ukazuje, jak přidat panel nástrojů do okna nástroje.

Panel nástrojů je vodorovný nebo svislý pruh, který obsahuje tlačítka svázaná s příkazy. Délka panelu nástrojů v okně nástroje je vždy stejná jako šířka nebo výška okna nástroje v závislosti na tom, kde je panel nástrojů ukotvený.

Na rozdíl od panelů nástrojů v integrovaném vývojovém prostředí musí být panel nástrojů v okně nástroje ukotvený a nelze ho přesunout ani přizpůsobit. Pokud je balíček VSPackage napsaný v nespravovaném kódu, je možné panel nástrojů ukotvit na libovolném okraji.

Další informace o tom, jak přidat panel nástrojů, naleznete v tématu Přidání panelu nástrojů.

Vytvoření panelu nástrojů pro okno nástroje

1. Vytvořte projekt VSIX s názvem TWToolbar příkaz nabídky s názvem TWTestCommand a okno nástroje s názvem TestToolWindow. Další informace najdete v tématu Vytvoření rozšíření pomocí příkazu nabídky a vytvoření rozšíření pomocí okna nástroje. Před přidáním šablony okna nástroje je potřeba přidat šablonu položky příkazu.

2. V souboru TWTestCommandPackage.vsct vyhledejte část Symboly. V uzlu GuidSymbol s názvem guidTWTestCommandPackageCmdSet deklarujte panel nástrojů a skupinu panelů nástrojů následujícím způsobem.

   <IDSymbol name="TWToolbar" value="0x1000" />
   <IDSymbol name="TWToolbarGroup" value="0x1050" />
   

3. V horní části oddílu Commands vytvořte Menus oddíl. Menu Přidejte prvek pro definování panelu nástrojů.

   <Menus>
       <Menu guid="guidTWTestCommandPackageCmdSet" id="TWToolbar" type="ToolWindowToolbar">
           <CommandFlag>DefaultDocked</CommandFlag>
           <Strings>
               <ButtonText>Test Toolbar</ButtonText>
               <CommandName>Test Toolbar</CommandName>
           </Strings>
       </Menu>
   </Menus>
   

   Panely nástrojů nelze vnořit jako podnabídky. Proto nemusíte přiřazovat nadřazené položky. Také nemusíte nastavovat prioritu, protože uživatel může přesouvat panely nástrojů. Počáteční umístění panelu nástrojů je obvykle definováno programově, ale následné změny uživatelem se zachovají.

4. V části Skupiny definujte skupinu, která bude obsahovat příkazy pro panel nástrojů.

   
   <Group guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" priority="0x0000">
       <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbar" />
   </Group>
   

5. V části Tlačítka změňte nadřazenou položku existujícího prvku Button na skupinu nástrojů tak, aby se panel nástrojů zobrazil.

   <Button guid="guidTWTestCommandPackageCmdSet" id="TWTestCommandId" priority="0x0100" type="Button">
       <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" />
       <Icon guid="guidImages" id="bmpPic1" />
       <Strings>
           <ButtonText>Invoke TWTestCommand</ButtonText>
       </Strings>
   </Button>
   

   Pokud panel nástrojů nemá žádné příkazy, ve výchozím nastavení se nezobrazí.

   Protože nový panel nástrojů není automaticky přidán do okna nástroje, je nutné panel nástrojů přidat explicitně. Tento postup je popsán v následujícím oddíle.

Přidání panelu nástrojů do okna nástroje

1. Do TWTestCommandPackageGuids.cs přidejte následující řádky.

   public const string guidTWTestCommandPackageCmdSet = "00000000-0000-0000-0000-0000";  // get the GUID from the .vsct file
   public const int TWToolbar = 0x1000;
   

2. V TestToolWindow.cs přidejte následující příkaz using.

   using System.ComponentModel.Design;
   

3. Do konstruktoru TestToolWindow přidejte následující řádek.

   this.ToolBar = new CommandID(new Guid(TWTestCommandPackageGuids.guidTWTestCommandPackageCmdSet), TWTestCommandPackageGuids.TWToolbar);
   

Otestování panelu nástrojů v okně nástroje

1. Sestavte projekt a spusťte ladění. Měla by se zobrazit experimentální instance sady Visual Studio.

2. V nabídce View / Other Windows klepněte na tlačítko Test ToolWindow zobrazte okno nástroje.

   V levém horním rohu okna nástroje by se měl zobrazit panel nástrojů (vypadá jako výchozí ikona).

3. Na panelu nástrojů klikněte na ikonu a zobrazte zprávu TWTestCommandPackage Inside TWToolbar.TWTestCommand.MenuItemCallback().

Související obsah

• Přidání panelu nástrojů