Sdílet prostřednictvím

Registrace obslužných rutin příkazů definičních sestavení

  • Článek

Balíček VSPackage se musí zaregistrovat v sadě Visual Studio, aby integrované vývojové prostředí (IDE) správně směrovala své příkazy.

Registr lze aktualizovat buď ruční úpravou, nebo pomocí souboru registrátora (.rgs). Další informace naleznete v tématu Vytváření skriptů registrátora.

Rozhraní MPF (Managed Package Framework) poskytuje tuto funkci prostřednictvím ProvideMenuResourceAttribute třídy.

  • Referenční zdroje formátu tabulky příkazů jsou umístěny v nespravovaných satelitních knihovnách DLL uživatelského rozhraní.

Registrace obslužné rutiny příkazu balíčku VSPackage

Balíček VSPackage fungující jako obslužná rutina pro příkazy založené na uživatelském rozhraní (UI) vyžaduje položku registru pojmenovanou po VSPackage GUID. Tato položka registru určuje umístění souboru prostředku uživatelského rozhraní VSPackage a prostředku nabídky v tomto souboru. Samotná položka registru se nachází ve složce HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\<Version>\Menus, kde <verze> je verze sady Visual Studio, například 9.0.

Poznámka:

Kořenovou cestu HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> lze při inicializaci prostředí sady Visual Studio přepsat pomocí alternativního kořenového adresáře. Další informace o kořenové cestě naleznete v tématu Instalace balíčku VSPackages pomocí Instalační služby systému Windows.

Položka registru prostředků CTMENU

Struktura položky registru je:

HKEY_LOCAL_MACHINE\Software\VisualStudio\<Version>\
  Menus\
    <GUID> = <Resource Information>

<Identifikátor GUID> je GUID balíček VSPackage ve formátu {XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX}.

<Informace o> zdroji se skládají ze tří prvků oddělených čárkami. Tyto prvky jsou v pořadí:

<Cesta k knihovně DLL> prostředků,< ID> prostředku nabídky, <verze nabídky>

Následující tabulka popisuje pole <Informace o> zdroji.

Element (Prvek) Popis
<Cesta k knihovně DLL prostředků> Toto je úplná cesta k knihovně DLL prostředků, která obsahuje prostředek nabídky, nebo je ponechána prázdná, což znamená, že knihovna DLL prostředků balíčku VSPackage se má použít (jak je uvedeno v podklíči Packages, kde je registrován balíček VSPackage).

Toto pole je obvykle ponecháno prázdné.
<ID prostředku nabídky> Toto je ID CTMENU prostředku, který obsahuje všechny prvky uživatelského rozhraní pro balíček VSPackage zkompilovaný ze souboru .vsct .
<Verze nabídky> Jedná se o číslo, které se používá jako verze CTMENU prostředku. Visual Studio tuto hodnotu používá k určení, jestli je potřeba znovu vytvořit obsah CTMENU prostředku se svou mezipamětí všech CTMENU prostředků. Remerge se aktivuje spuštěním příkazu devenv setup.

Tato hodnota by měla být zpočátku nastavena na 1 a zvýšit po každé změně CTMENU prostředku a před opakováním.

Příklad

Tady je příklad několika položek prostředků:

HKEY_LOCAL_MACHINE\Software\VisualStudio\9.0Exp\
  Menus\
    {019971D6-4685-11D2-B48A-0000F87572EB} = ,1, 10
    {1b027a40-8f43-11d0-8d11-00a0c91bc942} = , 10211, 3

Související obsah