How to: Exibir um ícone Personalizar a Adicionar-no Botão

Artigo
08/04/2011

Você pode substituir o ícone padrão (-feliz) que exibe a próxima ao seu comando add-in com um ícone que não é um dos ícones padrão predefinidos como descrito na How to: Alterar o ícone Padrão para um Adicionar-em.

Para fazer isso:

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

O procedimento a seguir demonstra como adicionar um ícone personalizado para o botão add-in.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Esses procedimentos foram desenvolvidos com o General Development Settings ativo. Para alterar as configurações, escolha importação e Exportar configurações sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Esses procedimentos foram desenvolvidos com o General Development Settings ativo. Para alterar as configurações, escolha importação e Exportar configurações sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para adicionar um bitmap personalizado como um ícone de botão add-in para um projeto de suplemento

Abra uma solução de suplemento existente ou criar uma nova solução suplemento em Visual Studio.
Adicione um novo arquivo de recurso ao seu projeto de suplemento. Para fazer isso:
1. Clique com o botão direito no projeto do suplemento na Solution Explorer.
2. Selecione Novo Item sobre o Add menu.
3. Selecione O arquivo de recursos nos modelos de lista e clique no Add botão. Deixe seu nome padrão (Resources1.resx).
  
  Isso inicia o Visual Studio Editor de recursos.
Se o arquivo de recurso não aparecer em Solution Explorer, clique o Mostrar todos os arquivos o botão na barra de ferramentas.
Add-ins requerem um valor inteiro como o argumento de bitmap. A definição dessa propriedade permite que você edite o arquivo de recurso e nomeie seu recurso de bitmap com um identificador numérico, algo que você não pode fazer quando o arquivo. resx é parte do projeto do suplemento.
No Editor de recursos, clique em Add Resourcee na lista suspensa Selecionar Nova imagem, em seguida, Imagem BMP. Por enquanto, deixe seu nome padrão (Image1.bmp).

Como alternativa, você pode selecionar uma imagem de bitmap existente é de 16 x 16 pixels e 16 cores ou True Color. Ícones personalizados para suplementos devem ter 16 x 16 pixels e ser 16-color ou True Color.
Na janela de propriedades do bitmap, alterar tanto a altura e largura propriedades para 16. Definir o cores propriedade 16 cores ou em True Color.
Se você criou um novo bitmap, edite a figura de Editor de recursos.

Abra a classe de conectar-se para o suplemento. No OnConnection método na AddNamedCommand2 linha, alterar o MSOButton o valor do parâmetro de true para falsee o Bitmap valor do parâmetro 59 para 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 a MSOButton argumento para falso força o add-in para pesquisar em um arquivo de recurso para o bitmap de botão. O número, 1, será o identificador para esse bitmap. (Ele é definido em uma etapa posterior).

Quando tiver terminado, selecione Salvar tudo na arquivo menu, selecione Build Solution na Build menu e, depois de descarregar o projeto. Para fazer isso, clique com o botão direito no nó do projeto em Solution Explorer e, em seguida, clique em Unload Project.
Em Windows Explorer, use o bloco de notas para editar o arquivo Resource1.resx.
Procurar todas as instâncias de "Image1." e alterá-las para "1". Quando tiver terminado, salve o arquivo.
Na pasta \Resources para o suplemento, altere o nome do arquivo de bitmap de Image1.bmp para 1.bmp.
Recarregar o projeto de suplemento novamente (botão direito do mouse no nó do projeto em Solution Explorer e clicando em Reload Project) e executá-lo.
Clique o Ferramentas menu.

O add-in aparece no Ferramentas menu juntamente com seu ícone personalizado.

Para adicionar um bitmap personalizado como um ícone de botão add-in para um add-in do Visual C++ nativo

Siga os mesmos procedimentos, conforme descrito acima, mas altere os seguintes itens.
Criar uma nova Visual C++ projeto de DLL Win32.
Adicione um arquivo de recurso (. rc).
No modo de exibição de recursos, adicionar um bitmap (16 x 16) e dê a ele uma ID numérica.

O bitmap deve ser 16 x 16 pixels e 16 cores ou True Color.
Atualização do AddNamedCommand2 método de Connect.cpp com MSOButton definido como VARIANT_FALSE, e Bitmap definido para a identificação do bitmap que você atribuiu anteriormente.
Construa a DLL.
Crie uma subpasta "1033" (para uma localidade em inglês) no diretório DLL nativo add-in.
Copiar a DLL satélite para "1033" diretório.

Abra o AddIn.rgs e adicione dois valores de chave de 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'
                     }
                  }
               }
            }
         }
      }
   }

No "satellitedllpath" não adicione a identificação de localidade no caminho. Ele será acrescentado automaticamente no tempo de execução.

Reconstrua o add-in para registrar as informações atualizadas.

Consulte também

Tarefas

How to: Alterar o ícone Padrão para um Adicionar-em

How to: Expor uma Adicionar-em como um Botão na Barra de Ferramentas

Conceitos

Exibindo Ins Adicionar-nas barras de ferramentas e Menus

Compartilhar via