Como: exibir um ícone personalizado no botão Add-In

Artigo
02/25/2013

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

Você faz isso por:

Adicionando o ícone do bitmap 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 de í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.

Observação
As caixas de diálogo e comandos de menu você vê podem diferir daquelas descritas na ajuda dependendo de suas configurações ativas ou versão.Esses procedimentos foram desenvolvidos com as configurações gerais de desenvolvimento ativos.Para alterar as configurações, escolha Importar e ExportarConfigurações no menu de Ferramentas .Para mais informações, consulte Configurações de Visual Studio.

As caixas de diálogo e comandos de menu você vê podem diferir daquelas descritas na ajuda dependendo de suas configurações ativas ou versão.Esses procedimentos foram desenvolvidos com as configurações gerais de desenvolvimento ativos.Para alterar as configurações, escolha Importar e ExportarConfigurações no menu de Ferramentas .Para mais informações, consulte Configurações de 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 StudioEditor 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 e, 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 um da cor 16 ou cor verdadeira.Ícones personalizados para suplementos deve ser 16 x 16 pixels e ser qualquer um da cor 16 ou cor verdadeira.
Em a janela propriedades de bitmap, altere as propriedades de Altura e de Largura a 16.Defina a propriedade de Cores para qualquer um da cor 16 ou cor verdadeira.
Se você criou um novo bitmap, edite a imagem em Editor de Recurso.

Abra a classe para conectar o suplemento.Em o 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 para 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 , Compilar solução selecione 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 Arquivo Explorer, use Bloco de Notas para editar o arquivo Resource1.resx.
Procure por todas as ocorrências de “Image1” e altere-o para “1 ". Quando você terminar, salve o arquivo.
Em a pasta \ recursos para o suplemento, altere o nome de 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 botão ao ícone um suplemento nativo para Visual C++

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

O bitmap deve ser 16 x 16 pixels e qualquer um da cor 16 ou cor verdadeira.
Atualizar o método de AddNamedCommand2 em Connect.cpp com MSOButton definido como VARIANT_FALSE, e Bitmap definido como a identificação 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 adicionar 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 para um suplemento

Como: expor um suplemento como um botão na barra de ferramentas

Conceitos

Exibindo os suplementos nas barras de ferramentas e Menus

Partilhar via