Classe ThumbnailAttribute

Articolo
08/11/2011

Associa un'icona a un controllo Windows Presentation Foundation (WPF) o Silverlight personalizzato nella casella degli strumenti di Visual Studio o Expression Blend.

Gerarchia di ereditarietà

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

Spazio dei nomi: Microsoft.Windows.Design
Assembly: Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)

Sintassi

'Dichiarazione
<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

Il tipo ThumbnailAttribute espone i seguenti membri.

Costruttori

	Nome	Descrizione
	ThumbnailAttribute	Inizializza una nuova istanza della classe ThumbnailAttribute.

In alto

Proprietà

	Nome	Descrizione
	ResourceAssembly	Ottiene l'assembly che contiene l'immagine dell'icona.
	ResourceName	Ottiene il nome dell'immagine dell'icona.
	TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

In alto

Metodi

	Nome	Descrizione
	Equals	Infrastruttura. Restituisce un valore che indica se l'istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	GetHashCode	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	IsDefaultAttribute	Quando è sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito della classe derivata. (Ereditato da Attribute)
	Match	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	_Attribute.GetIDsOfNames	Esegue il mapping di un set di nomi a un set corrispondente di ID di invio. (Ereditato da Attribute)
	_Attribute.GetTypeInfo	Recupera le informazioni sul tipo relative a un oggetto, che possono essere utilizzate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
	_Attribute.GetTypeInfoCount	Recupera il numero delle interfacce di informazioni di tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
	_Attribute.Invoke	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

In alto

Note

Applicare ThumbnailAttribute per assegnare un'icona della casella degli strumenti a un controllo WPF o Silverlight personalizzato.

Nella procedura riportata di seguito viene illustrato come aggiungere un'icona che rappresenta il controllo a un tipo.

Creare un assembly di metadati in fase di progettazione per il controllo personalizzato. Per ulteriori informazioni, vedere Procedura dettagliata: aggiunta di metadati della fase di progettazione personalizzati.
Aggiungere un'immagine in corrispondenza della stessa gerarchia di cartelle del tipo passato a ThumbnailAttribute. Le estensioni e i tipi di file supportati sono BMP, GIF, JPG, JPEG e PNG.

I diversi host di finestre di progettazione utilizzano dimensioni di immagini diverse per l'icona della casella degli strumenti. È possibile specificare un'immagine diversa per WPF Designer ed Expression Blend specificando ThumbnailAttribute negli assembly di metadati specifici dell'host, *.VisualStudio.Design.dll e *.Expression.Design.dll.

Expression Blend utilizza il valore 24x24 per la dimensione dell'icona grande e il valore 12x12 per la dimensione dell'icona piccola. WPF Designer utilizza 16x16. Per ulteriori informazioni, vedere la classe Icone della casella degli strumenti.
Nella finestra Proprietà, impostare l'operazione di compilazione per l'immagine su Risorsa incorporata.

Nota

Le sottocartelle del progetto influiscono sullo spazio dei nomi in cui si trovano le risorse incorporate.
Implementare l'interfaccia IProvideAttributeTable per aggiungere l'oggetto ThumbnailAttribute alla classe di controllo. È possibile riutilizzare la stessa immagine in più tipi applicando lo stesso oggetto ThumbnailAttribute a più controlli.

ThumbnailAttribute viene utilizzato anche per individuare un'icona predefinita per i tipi aggiunti alla funzionalità "nuova istanza" dell'editor dell'insieme o dell'editor delle proprietà secondarie.