Registrando manipuladores de comando de montagem de interoperabilidade

Um VSPackage deve se registrar com o Visual Studio para que o ambiente de desenvolvimento integrado (IDE) roteie seus comandos corretamente.

O registo pode ser atualizado através de edição manual ou utilizando um ficheiro Registrar (.rgs). Para obter mais informações, consulte Criando scripts de registrador.

O MPF (Managed Package Framework) fornece essa funcionalidade por meio da ProvideMenuResourceAttribute classe.

Command Handler Registro de um VSPackage

Um VSPackage atuando como um manipulador para comandos baseados em interface do usuário (UI) requer uma entrada do Registro com o nome do VSPackage GUID. Essa entrada do Registro especifica o local do arquivo de recurso da interface do usuário do VSPackage e o recurso de menu dentro desse arquivo. A entrada do Registro em si está localizada em HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\<Version>\Menus, onde <Version> é a versão do Visual Studio, por exemplo 9.0.

Observação

O caminho raiz de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> pode ser substituído por uma raiz alternativa quando o shell do Visual Studio é inicializado. Para obter mais informações sobre o caminho raiz, consulte Instalando VSPackages com o Windows Installer.

A entrada no Registro de Recursos do CTMENU

A estrutura da entrada de registo é:

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

< GUID> é o GUID do VSPackage no formato {XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX}.

<As Informações> de Recursos consistem em três elementos separados por vírgulas. Estes elementos são, por ordem:

< Caminho para a DLL de Recursos>, <ID de Recurso do Menu>, <Versão do Menu>

A tabela a seguir descreve os campos das <Informações do Recurso>.

Elemento Description
< Caminho para a DLL do recurso> Este é o caminho completo para a DLL de recurso que contém o recurso de menu ou isso é deixado em branco, indicando que a DLL de recurso do VSPackage deve ser usada (conforme especificado na subchave Packages onde o próprio VSPackage está registrado).

É habitual deixar este campo em branco.
< ID do recurso de menu> Esta é a ID do recurso CTMENU que contém todos os elementos da interface de utilizador para o VSPackage compilado a partir de um ficheiro .vsct.
< Versão do menu> Este é um número usado como uma versão para o CTMENU recurso. Visual Studio usa este valor para determinar se ele precisa mesclar novamente os conteúdos do CTMENU recurso com a sua cache de todos os recursos CTMENU. Uma remesclagem é acionada executando o comando devenv setup.

Esse valor deve ser inicialmente definido como 1 e incrementado após cada alteração no recurso CTMENU e antes que a re-fusão ocorra.

Example

Aqui está um exemplo de algumas entradas de recursos:

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

Conteúdo relacionado

  • Last updated on