Sdílet prostřednictvím


Přidání nabídky do řádku nabídek sady Visual Studio

Tento názorný postup ukazuje, jak přidat nabídku do řádku nabídek integrovaného vývojového prostředí (IDE) sady Visual Studio. Řádek nabídek integrovaného vývojového prostředí (IDE) obsahuje kategorie nabídek, jako jsou Soubor, Úpravy, Zobrazení, Okno a Nápověda.

Před přidáním nové nabídky do řádku nabídek sady Visual Studio zvažte, jestli se vaše příkazy mají umístit do existující nabídky. Další informace o umístění příkazů naleznete v tématu Nabídky a příkazy pro Visual Studio.

Nabídky jsou deklarovány v souboru .vsct projektu. Další informace o nabídkách a souborech .vsct naleznete v tématu Příkazy, nabídky a panely nástrojů.

Po dokončení tohoto návodu můžete vytvořit nabídku s názvem Testovací nabídka , která obsahuje jeden příkaz.

Poznámka:

Počínaje sadou Visual Studio 2019 jsou nabídky nejvyšší úrovně, které přispěly rozšířeními, umístěny v nabídce Rozšíření .

Vytvoření projektu VSIX s vlastní šablonou položky příkazu

  1. Vytvořte projekt VSIX s názvem TopLevelMenu. Šablonu projektu VSIX najdete v dialogovém okně Nový projekt vyhledáním "vsix". Další informace najdete v tématu Vytvoření rozšíření pomocí příkazu nabídky.

  2. Po otevření projektu přidejte vlastní šablonu položky příkazu s názvem TestCommand. V Průzkumník řešení klikněte pravým tlačítkem myši na uzel projektu a vyberte Přidat>novou položku. V dialogovém okně Přidat novou položku přejděte na Visual C# / Rozšiřitelnost a vyberte Příkaz. V poli Název v dolní části okna změňte název souboru příkazu na TestCommand.cs.

Vytvoření nabídky na řádku nabídek integrovaného vývojového prostředí

  1. V Průzkumník řešení otevřete TopLevelMenuPackage.vsct.

    Na konci souboru je <Symbols> uzel, který obsahuje několik <GuidSymbol> uzlů. Do uzlu s názvem guidTopLevelMenuPackageCmdSetpřidejte nový symbol následujícím způsobem:

    <IDSymbol name="TopLevelMenu" value="0x1021"/>
    
  2. Vytvoření prázdného <Menus> uzlu v <Commands> uzlu těsně před <Groups>. <Menus> Do uzlu přidejte <Menu> uzel následujícím způsobem:

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

    Hodnoty guid nabídky id určují sadu příkazů a konkrétní nabídku v sadě příkazů.

    id Hodnoty guid nadřazené pozice nabídky v části řádku nabídek sady Visual Studio, který obsahuje nabídky Nástroje a doplňky.

    Prvek <ButtonText> určuje, že text by se měl zobrazit v položce nabídky.

  3. <Groups> V části vyhledejte <Group> a změňte <Parent> prvek tak, aby odkazovat na nabídku, která jsme právě přidali:

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

    Díky tomu je skupina součástí nové nabídky.

  4. <Buttons> V části vyhledejte <Button> uzel. Potom v <Strings> uzlu změňte prvek na <ButtonText> Test Command.

    Všimněte si, že šablona balíčku sady Visual Studio vygenerovala Button prvek, který má nadřazený objekt nastaven na MyMenuGroup. V důsledku toho se tento příkaz zobrazí v nabídce.

Sestavení a otestování rozšíření

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

  2. Nabídka Rozšíření v experimentální instanci by měla obsahovat nabídku Testovací nabídka .

  3. V nabídce Testovací nabídka vyberte příkaz Test.

    Mělo by se zobrazit okno se zprávou TestCommand Inside TopLevelMenu.TestCommand.MenuItemCallback()".