Compartilhar via

Classe ThumbnailAttribute

  • Artigo

Associa um ícone de um controle personalizado do Silverlight ou de Windows Presentation Foundation (WPF) da caixa de ferramentas Visual Studio ou Expression Blend. 

Hierarquia de herança

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

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

Sintaxe

'Declaração
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute

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

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

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)>]
type ThumbnailAttribute =  
    class
        inherit Attribute
    end

public final class ThumbnailAttribute extends Attribute

O tipo ThumbnailAttribute expõe os membros a seguir.

Construtores

  Nome Descrição
Método público ThumbnailAttribute Initializes a new instance of the ThumbnailAttribute class.

Início

Propriedades

  Nome Descrição
Propriedade pública ResourceAssembly Obtém o assembly que contém a imagem do ícone.
Propriedade pública ResourceName Obtém o nome da imagem do ícone.
Propriedade pública TypeId Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute.)

Início

Métodos

  Nome Descrição
Método público Equals Infraestrutura. Returns a value that indicates whether this instance is equal to a specified object. (Herdado de Attribute.)
Método protegido Finalize Permite que um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele é recuperado pela coleta de lixo. (Herdado de Object.)
Método público GetHashCode Retorna o código hash para essa instância. (Herdado de Attribute.)
Método público GetType Obtém o Type da instância atual. (Herdado de Object.)
Método público IsDefaultAttribute Quando substituído em uma classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada. (Herdado de Attribute.)
Método público Match Quando substituído em uma classe derivada, retorna um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute.)
Método protegido MemberwiseClone Cria uma cópia superficial do atual Object. (Herdado de Object.)
Método público ToString Retorna um string que representa o objeto atual. (Herdado de Object.)

Início

Implementações explícitas da interface

  Nome Descrição
Implementação explícita da interfaceMétodo particular _Attribute.GetIDsOfNames Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho. (Herdado de Attribute.)
Implementação explícita da interfaceMétodo particular _Attribute.GetTypeInfo Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute.)
Implementação explícita da interfaceMétodo particular _Attribute.GetTypeInfoCount Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1). (Herdado de Attribute.)
Implementação explícita da interfaceMétodo particular _Attribute.Invoke Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute.)

Início

Comentários

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

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

  1. Crie um assembly de metadados de tempo de design para o controle personalizado. For more information, see Passo a passo: Fornecendo metadados de tempo de design personalizados.

  2. Adicionar uma imagem na mesma hierarquia de pasta como o tipo que você passar para o ThumbnailAttribute. Tipos de arquivo e extensões aceitas são BMP, GIF, JPG, JPEG e PNG.

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

    Expression Blend usa 12 x 12 e 24 24 horas para o tamanho do ícone grande para o tamanho do ícone pequeno. O WPF Designer usa 16 x 16. For more information, see Ícones de caixa de ferramentas.

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

    ObservaçãoObservação

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

  4. Implementar a IProvideAttributeTable interface para adicionar o ThumbnailAttribute a classe de. do controle Você pode reutilizar a mesma imagem em vários tipos, aplicando o mesmo ThumbnailAttribute para vários controles.

    O ThumbnailAttribute também é usado para localizar um ícone padrão para tipos adicionados para o Editor de coleção ou subpropriedades Editor "nova instância de" funcionalidade.

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

Namespace Microsoft.Windows.Design

ToolboxBrowsableAttribute

Outros recursos

Ícones de caixa de ferramentas

Passo a passo: Criando um ícone de caixa de ferramentas personalizada para um controle