Como exibir um ícone personalizado no botão de suplemento

Artigo
06/10/2015

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Você pode substituir o ícone padrão (uma smiley- cara) que exibe ao lado do comando do suplemento com um ícone que não é um dos ícones padrões predefinidos de acordo com Como alterar o ícone padrão de um suplemento.

Você faz isso por:

Adicionando o bitmap de ícone como um recurso em seu projeto.
Definindo o parâmetro de MSOButton no método de AddNamedCommand2 a false (que notifica o método para procurar o bitmap do ícone).
Referenciando número de identificação de aquele recurso na parte commandbar do projeto do suplemento.

O procedimento a seguir demonstra como adicionar um ícone personalizado para o botão do suplemento.

Dica

As caixas de diálogo e os comandos de menu que você vê podem diferir das descritas no Help dependendo de suas configurações ativas ou de edição.Esses procedimentos foram desenvolvidos com as Configurações Gerais de Desenvolvimento ativas.Para alterar as configurações, escolha Importar e ExportarConfigurações no menu de Ferramentas.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Para adicionar um bitmap customizado como um ícone de botão do suplemento a um suplemento projeto

Abra uma solução existente do suplemento, ou criar uma nova solução do suplemento em Visual Studio.
Adicione um novo arquivo de recurso ao seu projeto do suplemento. Para fazer isso:
1. Clique com o botão direito do mouse no projeto do suplemento em Gerenciador de Soluções.
2. Selecione Novo Item no menu de Adicionar .
3. Selecione Arquivo de Recursos na lista de modelos e clique no botão de Adicionar . Deixe o nome padrão (Resources1.resx).
  
  Isso é Visual Studio Editor de Recurso.
Se o arquivo de recurso não aparece em Gerenciador de Soluções, clique no botão de Mostrar todos os arquivos na barra de ferramentas.
Suplementos requer um valor inteiro como o argumento de bitmap. Defina essa propriedade permite que você edite o arquivo de recurso e para nomear o recurso de bitmap com um identificador numérico, algo que você não pode fazer quando o arquivo .resx é parte do projeto do suplemento.
Em Editor de Recurso, clique em Adicionar Recurso, e de Nova Imagemselecione lista suspensa, em seguida Imagem BMP. Por enquanto, deixe o nome padrão (Image1.bmp).

Como alternativa, você pode selecionar uma imagem de bitmap existente que é 16 x 16 pixels e qualquer pessoa a cor 16 ou cor verdadeira. Os ícones indicadores personalizados para suplementos devem ser 16 x 16 pixels e ser tanto a cor 16 ou cor verdadeira.
Na janela propriedades de bitmap, altere as propriedades de Altura e de Largura a 16. Defina a propriedade de Cores para qualquer a cor 16 ou cor verdadeira.
Se você criou um novo bitmap, edite a imagem em Editor de Recurso.

Abra a classe conectar para o suplemento. No método de OnConnection na linha de AddNamedCommand2 , altere o valor do parâmetro de MSOButton de true a false, e o valor do parâmetro de Bitmap de 59 a 1. Por exemplo:

command = commands.AddNamedCommand2(_addInInstance, "MyAddin1", " 
MyAddin1", "Executes the command for MyAddin1", False, 1, Nothing, 
CType(vsCommandStatus.vsCommandStatusSupported, Integer) + 
CType(vsCommandStatus.vsCommandStatusEnabled, Integer), 
vsCommandStyle.vsCommandStylePictAndText, 
vsCommandControlType.vsCommandControlTypeButton)

Command command = commands.AddNamedCommand2(_addInInstance, 
"MyAddin1", "MyAddin1", "Executes the command for MyAddin1", false, 
1, ref contextGUIDS, 
(int)vsCommandStatus.vsCommandStatusSupported+(int)vsCommandStatus.
vsCommandStatusEnabled, (int)vsCommandStyle.vsCommandStylePictAndText, 
vsCommandControlType.vsCommandControlTypeButton);

Definindo o argumento de MSOButton a força falsas o suplemento a aparência a um arquivo de recurso para o bitmap do botão. O número, 1, será o identificador para esse bitmap. (É definido em uma etapa posterior.)

Quando você terminar, Salvar Tudo selecione no menu de Arquivo , selecione Compilar solução no menu de Compilar , e descarregam no projeto. Para fazer isso, clique com o botão direito do mouse no nó de projeto em Gerenciador de Soluções e clique em Descarregar projeto.
Em Explorador de Arquivos, use Bloco de Notas para editar o arquivo Resource1.resx.
Pesquise por todas as ocorrências de “Image1” e altere-o para “1 ". Quando você terminar, salve o arquivo.
Na pasta \ de recursos para o suplemento, altere o nome do arquivo de bitmap de Image1.bmp a 1.bmp.
Recarregar o projeto do suplemento novamente (clique com o botão direito do mouse no nó de projeto em Gerenciador de Soluções e clicando em Recarregar projeto) e executá-lo.
Clique no menu de Ferramentas .

O suplemento aparece no menu de Ferramentas junto com seu ícone personalizado.

Para adicionar um bitmap customizado como um suplemento próximo o ícone a um suplemento nativo para Visual C++

Siga os mesmos procedimentos que delineados anteriormente, mas alterar os seguintes itens.
Crie um novo projeto DLL de Visual C++ Win32.
Adicione um Arquivo de recursos (.rc).
No modo de recurso, adicione um bitmap (16 x 16) e dê a ela uma identificação numérica

O bitmap deve ser 16 x 16 pixels e qualquer pessoa a cor 16 ou cor verdadeira.
Atualizar o método de AddNamedCommand2 em Connect.cpp com MSOButton definido como VARIANT_FALSE, e Bitmap definido para o ID de bitmap que você atribuiu anteriormente.
Compile o DLL.
Crie uma subpasta “1033” (para a localidade em inglês) no diretório nativo de DLL do suplemento.
Copie o DLL satélite para “1033” diretórios.

Abra AddIn.rgs e adicione dois valores da chave do Registro “SatelliteDllName” e “SatelliteDllPath”. Por exemplo:

HKCU
{
   NoRemove 'SOFTWARE'
   {
      NoRemove 'Microsoft'
      {
         NoRemove 'VisualStudio'
         {
            NoRemove '8.0'
            {
               NoRemove 'AddIns'
               {
                  ForceRemove 
                    'NativeAddinCustBitmap.Connect'
                     {
                       val LoadBehavior = d 0
                       val CommandLineSafe = d 0
                       val CommandPreload = d 1
                       val FriendlyName = s 'NativeAddinCustBitmap'
                       val Description = s 'NativeAddinCustBitmap 
                         Description'
                       val SatelliteDllName = s  
                         'NativeAddinCustBitmapUI.dll'
                       val SatelliteDllPath = s 
                         'C:\Test\CustomBitmap\NativeAddinCustBitmap
                         \NativeAddinCustBitmap\Debug'
                     }
                  }
               }
            }
         }
      }
   }

Em “SatelliteDllPath” não adicionar a ID local no caminho. Será acrescentado automaticamente em tempo de execução.

Crie o suplemento para registrar informações atualizadas.

Consulte também

Tarefas

Como alterar o ícone padrão de um suplemento

Como expor um suplemento como um botão da barra de ferramentas

Conceitos

Exibindo suplementos em barras de ferramentas e menus

Partilhar via