Dodawanie paska narzędzi do okna narzędzi

W tym przewodniku pokazano, jak dodać pasek narzędzi do okna narzędzi.

Pasek narzędzi to poziomy lub pionowy pasek zawierający przyciski powiązane z poleceniami. Długość paska narzędzi w oknie narzędzi jest zawsze taka sama jak szerokość lub wysokość okna narzędzi, w zależności od miejsca zadokowania paska narzędzi.

W przeciwieństwie do pasków narzędzi w środowisku IDE, pasek narzędzi w oknie narzędzi musi być zadokowany i nie można go przenosić ani dostosowywać. Jeśli pakiet VSPackage jest zapisywany w kodzie niezarządzanym, pasek narzędzi można zadokować na dowolnej krawędzi.

Aby uzyskać więcej informacji na temat dodawania paska narzędzi, zobacz Dodawanie paska narzędzi.

Tworzenie paska narzędzi dla okna narzędzi

1. Utwórz projekt VSIX o nazwie TWToolbar zawierający zarówno polecenie menu o nazwie TWTestCommand, jak i okno narzędzia o nazwie TestToolWindow. Aby uzyskać więcej informacji, zobacz Create an extension with a menu command (Tworzenie rozszerzenia za pomocą polecenia menu) i Create an extension with a tool window (Tworzenie rozszerzenia za pomocą okna narzędzi). Przed dodaniem szablonu okna narzędzi należy dodać szablon elementu polecenia.

2. W pliku TWTestCommandPackage.vsct wyszukaj sekcję Symbole. W węźle GuidSymbol o nazwie guidTWTestCommandPackageCmdSet zadeklaruj pasek narzędzi i grupę pasków narzędzi w następujący sposób.

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

3. W górnej Commands części sekcji utwórz sekcję Menus . Dodaj element, Menu aby zdefiniować pasek narzędzi.

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

   Nie można zagnieżdżać pasków narzędzi, takich jak podmenu. W związku z tym nie musisz przypisywać elementu nadrzędnego. Ponadto nie musisz ustawiać priorytetu, ponieważ użytkownik może przenosić paski narzędzi. Zazwyczaj początkowe umieszczanie paska narzędzi jest definiowane programowo, ale kolejne zmiany przez użytkownika są utrwalane.

4. W sekcji Grupy zdefiniuj grupę zawierającą polecenia paska narzędzi.

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

5. W sekcji Przyciski zmień element nadrzędny istniejącego elementu Przycisk na grupę pasków narzędzi, aby pasek narzędzi był wyświetlany.

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

   Domyślnie, jeśli pasek narzędzi nie ma żadnych poleceń, nie jest wyświetlany.

   Ponieważ nowy pasek narzędzi nie jest automatycznie dodawany do okna narzędzi, należy jawnie dodać pasek narzędzi. Ta czynność została omówiona w następnej sekcji.

Dodawanie paska narzędzi do okna narzędzi

1. W TWTestCommandPackageGuids.cs dodaj następujące wiersze.

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

2. W TestToolWindow.cs dodaj następującą instrukcję using.

   using System.ComponentModel.Design;
   

3. W konstruktorze TestToolWindow dodaj następujący wiersz.

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

Testowanie paska narzędzi w oknie narzędzi

1. Skompiluj projekt i rozpocznij debugowanie. Powinno zostać wyświetlone wystąpienie eksperymentalne programu Visual Studio.

2. W menu Widok/Inne okna kliknij pozycję Test ToolWindow, aby wyświetlić okno narzędzia.

   Powinien zostać wyświetlony pasek narzędzi (wygląda jak ikona domyślna) w lewym górnym rogu okna narzędzia poniżej tytułu.

3. Na pasku narzędzi kliknij ikonę, aby wyświetlić komunikat TWTestCommandPackage Inside TWToolbar.TWTestCommand.MenuItemCallback().

Powiązana zawartość

• Dodawanie paska narzędzi