Udostępnij za pośrednictwem


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.

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()".