Partilhar via


Como alterar o ícone padrão de um suplemento

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 alterar o ícone associado com o comando de menu para um suplemento que você criou usando o tipo de projeto do suplemento a Visual Studio . Para localizar o tipo de projeto do suplemento, na caixa de diálogo Novo Projeto , expanda Outros tipos de projetos e clique em Projetos de Extensibilidade.

Quando você cria um suplemento usando o tipo de projeto do suplemento, Assistente de Suplemento permite que você adicione uma interface de usuário (UI) para o suplemento marcando a caixa de seleção Você desejar de criar uma barra de comandos interface do usuário para o suplemento? .

O modelo cria um comando no menu de Ferramentas que abre o suplemento. Por padrão, adjacente ao comando é um ícone de smiley- face. Você pode alterar o ícone usando um dos seguintes métodos:

  • Alterar o número de índice do ícone (que é 59 para o ícone padrão) para o número de outro ícone no assembly de Microsoft.VisualStudio.CommandBars . O assembly contém quase 3.000 ícones.

  • Defina um bitmap personalizado, por exemplo, um logotipo da empresa, compilá-lo em uma DLL satélite como um recurso, e alterá-lo no código do suplemento ao ponto para o novo projeto.

O primeiro método é mais rápido, mas você só pode usar ícones em Microsoft.VisualStudio.CommandBars. O segundo método permite que você use qualquer ícone.

Dica

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Para alterar o ícone atual para outro ícone

  1. Abra uma solução que é criado usando o tipo de projeto do suplemento.

  2. No arquivo de projeto, no método de OnConnection , procure a seguinte linha.

    command = commands.AddNamedCommand2(_addInInstance, _
      "MyAddin1", "MyAddin1",  _
      "Executes the command for MyAddin1", True, 59, 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", 
    true, 59, ref contextGUIDS, (int)vsCommandStatus.
    vsCommandStatusSupported+(int)vsCommandStatus.
    vsCommandStatusEnabled, (int)vsCommandStyle.
    vsCommandStylePictAndText, vsCommandControlType
    .vsCommandControlTypeButton);
    

    Observe o número 59 na chamada de AddNamedCommand2 . Este é o índice do ícone atual. Para alterar para um ícone padrão diferente, alterar esse número. Por exemplo, para alterar o ícone a uma estrela vermelha, altere 59 a 6743. Quando você executa o suplemento, o comando aparece no menu de Ferramentas juntamente com um ícone vermelho de estrela.

    Para obter informações sobre como localizar os números de identificação para ícones padrão, consulte Listando as faces de botão na barra de comandos para Microsoft Office system no site do MSDN.

  3. Se você não pode localizar um ícone na biblioteca de Microsoft.VisualStudio.CommandBars , você pode usar um bitmap personalizado. Compile o bitmap em uma DLL satélite como um recurso. Para obter mais informações, consulte Como exibir um ícone personalizado no botão de suplemento. Depois de criar o recurso satélite de DLL, apontar-lhe no AddNamedCommand2.

Consulte também

Tarefas

Como controlar suplementos usando o Gerenciador de Suplementos

Como criar um suplemento

Instruções passo a passo: criando um assistente

Conceitos

Registro de suplementos

Gráfico do modelo de objetos automation

Outros recursos

Criando suplementos e assistentes

Comandos e opções do Visual Studio