Classe ThumbnailAttribute

Associa um ícone com um controle personalizado do Windows Presentation Foundation (WPF) ou o Silverlight na caixa de ferramentas para Visual Studio ou o expressão Blend. 

Namespace:  Microsoft.Windows.Design
Assembly:  Microsoft.Windows.Design (em Microsoft.Windows.Design.dll)

Sintaxe

<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute

Dim instance As ThumbnailAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)]
public sealed class ThumbnailAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, AllowMultiple = true)]
public ref class ThumbnailAttribute sealed : public Attribute

public final class ThumbnailAttribute extends Attribute

Comentários

Aplicar o ThumbnailAttribute Para atribuir um ícone de caixa de ferramentas a um controle personalizado WPF ou do Silverlight.

As etapas a seguir mostram como adicionar um ícone que representa o controle a um tipo.

1. Crie um assembly de metadados de time de design para o controle personalizado.Para obter mais informações, consulte Como: Usar o armazenamento de metadados.

2. Adicionar uma imagem na mesma hierarquia de pastas sistema autônomo o tipo de que passar para o ThumbnailAttribute. Extensões aceitas e tipos de arquivo são BMP, GIF, JPG, JPEG e PNG.

   Diferentes hosts designer usam tamanhos de imagem diferente para o ícone caixa de ferramentas.Você pode especificar uma imagem diferente para o WPF Designer e o expressão Blend, especificando o ThumbnailAttribute nos assemblies do metadado específico do host *. VisualStudio.Design.dll e *. expressão.Design.dll.

   O expressão Blend usa 24 x 24 para o dimensionar de ícone grande e 12 x 12 para o dimensionar do ícone pequeno.The WPF Designer usa 16 x 16.

3. Na janela Propriedades, defina a ação de compilação para a imagem para EmbeddedResource.

   Observação:
   As subpastas do projeto afetam o namespace no qual os recursos incorporados são encontrados.

4. Use o Repositório de Metadados para adicionar o ThumbnailAttribute a classe do controle. Você pode reutilizar a mesma imagem em vários tipos, aplicando o mesmo ThumbnailAttribute a vários controles.

   The ThumbnailAttribute também é usado para localizar um ícone padrão para tipos adicionados ao Editor de coleção ou Editor Sub-Properties “ nova instância ” funcionalidade.

Exemplos

O exemplo de código a seguir mostra como adicionar o ThumbnailAttribute a um controle personalizado do Silverlight usando o MetadataStore.

public class Metadata : IRegisterMetadata
{
    public void Register()
    {
        AttributeTableBuilder builder = new AttributeTableBuilder();
        builder.AddCustomAttributes(typeof(Proseware.Core.Controls.ProseControl), 
        new ThumbnailAttribute(typeof(Metadata), "SLControlLibrary.Design. logo.gif"));
        MetadataStore.AddAttributeTable(builder.CreateTable());
    }
} 

Hierarquia de herança

System.Object
  System.Attribute
    Microsoft.Windows.Design.ThumbnailAttribute

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Membros ThumbnailAttribute

Namespace Microsoft.Windows.Design

ToolboxBrowsableAttribute

Date	History	Motivo
Julho de 2008	Tópico adicional para nova classe.	Alteração de recurso do SP1.