Udostępnij za pośrednictwem

Dodawanie menu do paska menu programu Visual Studio

  • Artykuł

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.

Uwaga

Począwszy od programu Visual Studio 2019, menu najwyższego poziomu dodane przez rozszerzenia są umieszczane w menu Rozszerzenia .

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