Ícones da caixa de ferramentas

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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

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

• BMP

• GIF

• JPG

• JPEG

• PNG

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 nomeada apropriadamente.

No caso mais simples, você adiciona o arquivo de imagem de ícone da caixa de ferramentas como um recurso incorporado ao projeto do seu controle. O nome de nomedocontrole. Extensãoe, na janela Properties, 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 da caixa de ferramentas personalizada para um controle.

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

AnyStringEspaço para nome. Nomedocontrole.Produto[.AnyString. Extensão

Quando um designer procura ícones da caixa de ferramentas, ele corresponde a espaço para nome, nomedocontrole, e produto substrings. Se espaço para nome 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.

• Espaço para nome. Nomedocontrole.VisualStudio. Extensão

• Espaço para nome. Nomedocontrole.VisualStudio. AnyString. Extensão

• Espaço para nome. Nomedocontrole.Expression.png

• Espaço para nome. Nomedocontrole.Expressão. AnyString. png

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

• Espaço para nome. Nomedocontrole. Extensão

• Espaço para nome. 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 espaço para nome. Informações opcionais adicionais sobre o formato de imagem são adicionadas, mas não são usadas por 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 processamento. O Visual Studio caixa de ferramentas carrega o ícone próximo ao 16 x 16 pixels e, em seguida, mapeia esse ícone para profundidade de cores de 24 bits.

3. Selecione o ícone que foi encontrado pela primeira vez.

Você pode usar o WPF Designer estrutura de extensibilidade para substituir os ícones de caixa de ferramentas que são incorporados no assembly de tempo de execução de um controle. Para obter mais informações, consulte Passo a passo: Fornecer metadados para os ícones da caixa de ferramentas.

Passo a passo: Fornecer metadados para os ícones da caixa de ferramentas

Ícones da caixa de ferramentas em Visual Studio de 2008