Ícones de caixa de ferramentas e recursos incorporados
Este tópico descreve como especificar um ícone personalizado do Toolbox para os controles do Windows Presentation Foundation (WPF) usando recursos incorporados.
Convenção de nomeação
Você associa um ícone de caixa de ferramentas a um controle personalizado seguindo uma convenção de nomeclatura.The Windows Presentation Foundation (WPF) Designer for Visual Studio examina os recursos incorporados no assembly do controle para um arquivo de imagem nomeado apropriadamente.
No caso mais simples, você deve adicionar o arquivo de imagem de ícone do Toolbox sistema autônomo recurso inserido ao projeto do controle.Nomeie a-Nome do controle.Extensão.The WPF Designer procura por um recurso com um nome de arquivo que corresponda ao nome do tipo do controle.
A tabela a seguir lista os tipos de arquivo com suporte para os ícones da caixa de ferramentas.
XAML
BMP
GIF
JPG
JPEG
PNG
Para obter mais informações, consulte Demonstra Passo a passo: Criando um ícone de caixa de ferramentas personalizado para um controle.
.gif "Observação") Observação: |
|---|
The WPF Designer usa um algoritmo de correspondência para encontrar o melhor recurso para um ícone de caixa de ferramentas. Se um arquivo de recurso inválido for XAML válido ou um arquivo de imagem válido, a próxima correspondência é usada até que uma for encontrada. Imagens XAML inválido podem conter referências a tipos que inválido sejam do sistema. |
Nome totalmente combinados
A convenção de nomeclatura do ícone caixa de ferramentas oferece suporte a nomes de recursos de correspondência totalmente.Para nomes totalmente correspondente, você incluir o espaço para nome no nome do ícone caixa de ferramentas, usando a seguinte convenção de Namespace.ControlName.Icon.Extensão.Por exemplo, considere um controle chamado ProseControl e definido no namespace Proseware.Core.Controls.Um ícone de PNG Toolbox totalmente correspondente para esse controle será nomeado Proseware.Core.Controls.ProseControl.Icon.png.
Para recursos, Visual Studio Converte automaticamente pastas em espaços para nome. Portanto, você pode criar uma estrutura de pastas no seu projeto é o mesmo que seu namespace.Esteja ciente de que pastas afetam o namespace no qual os recursos incorporados são encontrados. No exemplo anterior, se o arquivo de imagem está em uma subpasta chamado ícones, a WPF Designer pareceria de um ícone da caixa de ferramentas chamado Proseware.Core.Controls.Icons.ProseControl.Icon.png.
Se uma imagem não for encontrada na mesma namespace sistema autônomo o controle, a WPF Designer procura uma correspondência solta.
Nome livremente combinados
Se o WPF Designer não encontrar um recurso de correspondência totalmente, ele procurará correspondências ampliadas do assembly incorporado a recursos. No exemplo anterior, a WPF Designer primeira procura por um arquivo que possui o nome de correspondência totalmente Proseware.Core.Controls.ProseControl.ícone. Extensão.Se essa Pesquisar falhar, o WPF Designer ignora o namespace e procura por um nome com base no nome do tipo sozinho. Neste exemplo, a WPF Designer procura arquivos de recursos nomeados ProseControl.ícone. Extensão. Se essa Pesquisar falhar, o WPF Designer Inicia a Pesquisar do espaço para nome padrão. Neste exemplo, a WPF Designer procura arquivos chamados Proseware.ProseControl.ícone. Extensão.
Vários tamanhos de imagem
nome de arquivo de imagem de ícone Toolbox pode incluir um campo opcional "Ícone".Permite que este substring especificando vários tamanhos de imagem do ícone.
Controle ProseControl no exemplo anterior, a WPF Designer Localiza as imagens a seguir nos recursos e seleciona a melhor correspondência para dimensionar.
Proseware.Core.Controls.ProseControl.ícone.Large.PNG
Proseware.Core.Controls.ProseControl.ícone.meio.PNG
Proseware.Core.Controls.ProseControl.ícone.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
The WPF Designer Seleciona o ícone caixa de ferramentas com base nas seguintes regras.
Vetor de XAML.
Correspondência exata no dimensionar em ambas as dimensões.
Correspondência mais próxima com base no dimensionar e taxa de proporção.
O dimensionar da imagem recomendada para formatos de arquivo de bitmap é 64 pixels por 64 pixels.
The WPF Designer e expressão Blend usar tamanhos de imagem diferente para o ícone caixa de ferramentas. O expressão Blend usa 24 x 24 para o dimensionar de ícone grande e 12 x 12 para o dimensionar pequeno.The WPF Designer usa 16 x 16.
Se o dimensionar desejado pelo host é 64 x 64 pixels e Proseware.Core.Controls.ProseControl.ícone.Large.png é a melhor correspondência com base no dimensionar e taxa de proporção, esse arquivo é usado.Todas as imagens no conjunto de módulos (assembly) são examinadas.Se houver duas imagens com o mesmo dimensionar e taxa de proporção, o host decide que ele usa.
Consulte também
Tarefas
Demonstra Passo a passo: Criando um ícone de caixa de ferramentas personalizado para um controle