Dodawanie menu do paska menu programu Visual Studio

W tym przewodniku pokazano, jak dodać menu na pasku menu zintegrowanego środowiska projektowego (IDE) programu Visual Studio. Pasek menu IDE zawiera kategorie menu, takie jak Plik, Edycja, Widok, Okno i Pomoc.

Przed dodaniem nowego menu na pasku menu programu Visual Studio zastanów się, czy polecenia powinny zostać umieszczone w istniejącym menu. Aby uzyskać więcej informacji na temat umieszczania poleceń, zobacz Menu i polecenia dla programu Visual Studio.

Menu są deklarowane w pliku vsct projektu. Aby uzyskać więcej informacji na temat menu i plików vsct , zobacz Polecenia, menu i paski narzędzi.

Wykonując ten przewodnik, możesz utworzyć menu o nazwie Menu testowe zawierające jedno polecenie.

Tworzenie projektu VSIX z niestandardowym szablonem elementu polecenia

1. Utwórz projekt VSIX o nazwie TopLevelMenu. Szablon projektu VSIX można znaleźć w oknie dialogowym Nowy projekt , wyszukując frazę "vsix". Aby uzyskać więcej informacji, zobacz Create an extension with a menu command (Tworzenie rozszerzenia za pomocą polecenia menu).

2. Po otwarciu projektu dodaj niestandardowy szablon elementu polecenia o nazwie TestCommand. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Dodaj>nowy element. W oknie dialogowym Dodawanie nowego elementu przejdź do pozycji Visual C# / Rozszerzalność i wybierz pozycję Polecenie. W polu Nazwa w dolnej części okna zmień nazwę pliku polecenia na TestCommand.cs.

Tworzenie menu na pasku menu ŚRODOWISKA IDE

1. W Eksplorator rozwiązań otwórz plik TopLevelMenuPackage.vsct.

   Na końcu pliku znajduje <Symbols> się węzeł zawierający kilka <GuidSymbol> węzłów. W węźle o nazwie guidTopLevelMenuPackageCmdSetdodaj nowy symbol w następujący sposób:

   <IDSymbol name="TopLevelMenu" value="0x1021"/>
   

2. Utwórz pusty <Menus> węzeł w węźle <Commands> tuż przed <Groups>. W węźle <Menus> dodaj <Menu> węzeł w następujący sposób:

   <Menus>
         <Menu guid="guidTopLevelMenuPackageCmdSet" id="TopLevelMenu" priority="0x700" type="Menu">
           <Parent guid="guidSHLMainMenu"
                   id="IDG_VS_MM_TOOLSADDINS" />
           <Strings>
             <ButtonText>Test Menu</ButtonText>
           </Strings>
       </Menu>
   </Menus>
   

   Wartości guid i id menu określają zestaw poleceń i określone menu w zestawie poleceń.

   Wartości guid i id pozycji nadrzędnej menu w sekcji paska menu programu Visual Studio zawierającego menu Narzędzia i dodatki.

   Element <ButtonText> określa, że tekst powinien pojawić się w elemencie menu.

3. <Groups> W sekcji znajdź <Group> element i zmień <Parent> go, aby wskazywał właśnie dodane menu:

   <Groups>
       <Group guid="guidTopLevelMenuPackageCmdSet" id="MyMenuGroup" priority="0x0600">
           <Parent guid="guidTopLevelMenuPackageCmdSet" id="TopLevelMenu"/>
       </Group>
   </Groups>
   

   Dzięki temu grupa jest częścią nowego menu.

4. <Buttons> W sekcji znajdź <Button> węzeł. Następnie w węźle <Strings> zmień element na <ButtonText> Test Command.

   Zwróć uwagę, że szablon pakietu programu Visual Studio wygenerował Button element, który ma element nadrzędny ustawiony na MyMenuGroupwartość . W związku z tym to polecenie jest wyświetlane w menu.

Kompilowanie i testowanie rozszerzenia

1. Skompiluj projekt i rozpocznij debugowanie. Powinno zostać wyświetlone wystąpienie wystąpienia eksperymentalnego.

2. Menu Rozszerzenia w wystąpieniu eksperymentalnym powinno zawierać menu Menu testowe.

3. W menu Menu testowe wybierz polecenie Testuj polecenie.

   Powinno zostać wyświetlone okno komunikatu "TestCommand Inside TopLevelMenu.TestCommand.MenuItemCallback()".

Powiązana zawartość

• Polecenia, menu i paski narzędzi