Ícones de caixa de ferramentas no Visual Studio 2008

Artigo
08/01/2011

Você pode incluir ícones da caixa de ferramentas com seus controles personalizados de Windows Presentation Foundation (WPF) em Visual Studio. Este tópico descreve como nomear os ícones da caixa de ferramentas e incluí-las como recursos incorporados.

Observação
Este tópico é mantido para compatibilidade com Visual Studio 2008. For Visual Studio 2010, see Ícones de caixa de ferramentas.

Tipos de Arquivo suportados

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

XAML
BMP
GIF
JPG
JPEG
PNG

Convenção de nomenclatura

Você pode associar um ícone da caixa de ferramentas com um controle personalizado seguindo uma convenção de nomenclatura. O WPF Designer for Visual Studio examina 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ão. O WPF Designer procura por um recurso com um nome de arquivo que corresponde ao nome do tipo de controle. For more information, see Passo a passo: Criando um ícone de caixa de ferramentas personalizada para um controle.

Observação
O WPF Designer usa um algoritmo de correspondência para encontrar o melhor recurso para um ícone da caixa de ferramentas. Se um arquivo de recurso não é válidoXAML ou um arquivo deimagem válido, a próxima correspondência é usada até que uma for encontrada. ImagensXAML não podem conter referências a tipos de não-do sistema.

Totalmente-correspondido Nome

O ícone caixa de ferramentas totalmente compatível com a convenção de nomeação-nomes de recurso de correspondentes. Para correspondência totalmente de-nomes, você incluir o namespace no nome do ícone da caixa de ferramentas, usando a seguinte convenção de Namespace.ControlName.Ícone.Extensão. Por exemplo, considere um controle chamado ProseControl e é definido no namespacede Proseware.Core.Controls. A totalmente-corresponde o ícone da caixa de ferramentas do PNG para esse controle seria nomeado Proseware.Core.Controls.ProseControl.Icon.png.

Para recursos, Visual Studio converte automaticamente pastas namespaces. Portanto, você pode criar uma estrutura de pastas em seu projeto é o mesmo que seu namespace. Lembre-se de que as pastas afetam o namespace no qual os recursos incorporados são encontrados. No exemplo anterior, se o arquivo de imagem está em uma subpasta denominada ícones, o WPF Designer seria a aparência de um ícone da caixa de ferramentas chamado Proseware.Core.Controls.Icons.ProseControl.Icon.png.

Se uma imagem não for encontrado no mesmo namespace como o controle, o WPF Designer procura uma correspondência solto.

Vagamente-correspondido Nome

Se a WPF Designer não encontrar uma correspondência totalmente de- recurso, ele procura correspondências soltas em recursos incorporados do assembly. No exemplo anterior, o WPF Designer primeiro procura por um arquivo que tem o-correspondente nome totalmente Proseware.Core.Controls.ProseControl.Icon.Extensão. Se essa pesquisa falhar, o WPF Designer ignora o namespace e procura por um nome baseado no nome do tipo sozinho. Neste exemplo, o WPF Designer procura todos os arquivos de recursos denominados ProseControl.Icon.Extensão. Se essa pesquisa falhar, o WPF Designer inicia a pesquisa do padrão namespace. Neste exemplo, o WPF Designer procura arquivos chamados Proseware.ProseControl.Icon.Extensão.

Vários tamanhos de imagem

O nome de arquivo de imagem do ícone caixa de ferramentas pode incluir um "ícone" opcional ocampo. Este substring permite especificar vários tamanhos de imagem do ícone.

Para o controle de ProseControl no exemplo anterior, o WPF Designer as imagens a seguir nos recursos de localiza e seleciona o melhor correspondência de tamanho.

Proseware.Core.Controls.ProseControl.Icon.Large.PNG
Proseware.Core.Controls.ProseControl.Icon.Medium.PNG
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.PNG

Você também pode omitir o período que segue o "Ícone" Para especificar os seguintes nomes de arquivo.

Proseware.Core.Controls.ProseControl.IconLarge.PNG
Proseware.Core.Controls.ProseControl.IconMedium.PNG
Proseware.Core.Controls.ProseControl.IconReallyLarge.PNG

O WPF Designer seleciona o ícone da caixa de ferramentas com base nas regras a seguir.

Vetor de XAML.
Correspondência exata no tamanho em ambas as dimensões.
Correspondência mais próxima com base no tamanho e taxa de proporção.

O tamanho recomendado de imagem de bitmap-formatos de arquivo com base é 64 pixels por 64 pixels.

O WPF Designer e o Expression Blend usar tamanhos de imagem de diferente para o ícone da caixa de ferramentas. Expression Blend usa 12 x 12 e 24 24 horas para o tamanho do ícone grande para o tamanho pequeno. O WPF Designer usa 16 x 16.

Se o tamanho desejado pelo host é 64 x 64 pixels e Proseware.Core.Controls.ProseControl.Icon.Large.png é a melhor correspondência com base no tamanho e taxa de proporção, esse arquivo é usado. Tudo as imagens no assembly são examinados. Se houver duas imagens com o mesmo tamanho e a taxa de proporção, o host decide que ele usa.