Compartilhar via

Ícones de caixa de ferramentas

  • Artigo

Você pode incluir ícones da caixa de ferramentas com o seu personalizado WPF e Silverlight controles na Visual Studio e Expression Blend. Este tópico descreve como nomear os ícones da caixa de ferramentas e incluí-las como recursos incorporados.

Tipos de Arquivo suportados

A lista a seguir mostra os tipos de arquivo com suporte para ícones de ferramentas na WPF Designer for Visual Studio. 

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

ObservaçãoObservação

Expression Blend suporta somente os arquivos. png.

Convenção de nomenclatura

Você pode associar um ícone da caixa de ferramentas com um controle personalizado seguindo uma convenção de nomenclatura. Ferramentas de design de examinam os recursos incorporados no assembly do controle para um arquivo de imagem de nomeada apropriadamente.

No caso mais simples, você adicionar o arquivo de imagem de ícone da caixa de ferramentas como um recurso inserido do seu controle projeto. Nome - nomedocontrole.Extensãoe de janela Propriedades, defina sua Build Action para Embedded Resource. O WPF Designer procura por um recurso com um nome de arquivo que corresponde ao nome do tipo de controle. Para obter mais informações, consulte Passo a passo: Criando um ícone de caixa de ferramentas personalizada para um controle.

ObservaçãoObservação

Para compatibilidade com versões anteriores, Visual Studio 2010 suporta a convenção de nomenclatura usada por Visual Studio 2008. For more information, see Ícones de caixa de ferramentas no Visual Studio 2008.

Visual Studio 2010oferece suporte a seguinte convenção de nomenclatura para os ícones da caixa de ferramentas. As subseqüências colchetes ([]) são opcionais.

AnyStringNamespace.Nomedocontrole.Produto[.AnyString.Extensão

Quando um designer de procura de ícones da caixa de ferramentas, ela corresponde a Namespace, nomedocontrole, e produto substrings. Se Namespace e nomedocontrole não coincidem seu controle, o ícone não será exibido na caixa de ferramentas.

O produto subseqüência de caracteres pode ser usada por um designer para filtrar os ícones para outros produtos. Por exemplo, Visual Studio prefere ícones que têm produto definido como "visualstudio".

A lista a seguir mostra o exemplo convenções de nomenclatura de ícone de caixa de ferramentas você pode usar para Visual Studio e ícones do Expression Blend.

  • Namespace.Nomedocontrole.VisualStudio.Extensão

  • Namespace.Nomedocontrole.VisualStudio.AnyString.Extensão

  • Namespace.Nomedocontrole.Expression.PNG

  • Namespace.Nomedocontrole.Expressão.AnyString. PNG

Se nenhum ícone for encontrado que ajuste os nomes anteriores, os seguintes nomes são pesquisados.

  • Namespace.Nomedocontrole.Extensão

  • Namespace.Nomedocontrole.AnyString.Extensão

A lista a seguir mostra exemplo de nomes de ícones da caixa de ferramentas para um controle chamado TailspinToysControl na TailspinToysControlLibrary namespace. Informações opcionais adicionais sobre o formato de imagem são adicionadas, mas não são usadas pelos designers.

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

Depois que um designer encontra ícones da caixa de ferramentas, o ícone que mais corresponda ao tamanho do ícone de destino do designeré carregado para exibição. A lista a seguir mostra a ordem na qual os critérios de correspondência são aplicados.

  1. Selecione os ícones com o designer especificado no nome do ícone sobre ícones sem um designer especificado. Por exemplo, o WPF Designer prefere ícones que têm "visualstudio" em seu nome aqueles que têm "Expressão".

  2. Selecione o ícone que é a correspondência mais próxima para o tamanho de renderização . O Visual Studio Toolbox carrega o ícone próximo ao 16 x 16 pixels e mapeia esse ícone para 24-bits cor profundidade.

  3. Selecione o ícone que foi encontrado primeiro.

Substituindo os ícones de ferramentas Padrão

Você pode usar o WPF Designera estrutura deextensibilidade para substituir ícones de ferramentas que são incorporados em tempo de execuçãode um controleassembly. For more information, see Passo a passo: Fornecendo metadados para ícones de caixa de ferramentas.

Consulte também

Conceitos

Ícones de caixa de ferramentas no Visual Studio 2008

Outros recursos

Passo a passo: Fornecendo metadados para ícones de caixa de ferramentas