ThumbnailAttribute-Klasse

Ordnet einem benutzerdefinierten Windows Presentation Foundation (WPF)- oder Silverlight-Steuerelement in der Toolbox für Visual Studio oder Expression Blend ein Symbol zu.

Vererbungshierarchie

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

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

Syntax

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

Der ThumbnailAttribute-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	ThumbnailAttribute	Initialisiert eine neue Instanz der ThumbnailAttribute-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	ResourceAssembly	Ruft die Assembly ab, die das Symbolbild enthält.
	ResourceName	Ruft den Namen des Symbolbilds ab.
	TypeId	Bei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Infrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Gibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IsDefaultAttribute	Beim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
	Match	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	_Attribute.GetIDsOfNames	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
	_Attribute.GetTypeInfo	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
	_Attribute.GetTypeInfoCount	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
	_Attribute.Invoke	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)

Zum Seitenanfang

Hinweise

Übernehmen Sie das ThumbnailAttribute, um einem benutzerdefinierten WPF- oder Silverlight-Steuerelement ein Toolboxsymbol zuzuweisen.

In den folgenden Schritten wird dargestellt, wie ein Symbol zur Darstellung des Steuerelements zu einem Typ hinzugefügt wird.

Erstellen Sie eine Entwurfszeit-Metadatenassembly für das benutzerdefinierte Steuerelement. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Bereitstellen von benutzerdefinierten Entwurfszeitmetadaten.
Fügen Sie auf der gleichen Ordnerhierarchie wie der des Typs, den Sie an das ThumbnailAttribute übergeben, ein Bild hinzu. Unterstützte Erweiterungen und Dateitypen sind BMP, GIF, JPG, JPEG und PNG.

Andere Designerhosts verwenden andere Bildgrößen für das Toolboxsymbol. Sie können ein anderes Bild für den WPF-Designer und Expression Blend angeben, indem Sie das ThumbnailAttribute in den hostspezifischen Metadatenassemblys, *.VisualStudio.Design.dll und *.Expression.Design.dll, angeben.

Expression Blend verwendet 24x24 für die große Symbolgröße und 12x12 für die kleine Symbolgröße. Der WPF-Designer verwendet 16x16. Weitere Informationen finden Sie unter Toolboxsymbole.
Legen Sie im Eigenschaftenfenster den Buildvorgang für das Bild auf EmbeddedResource fest.

Tipp

Die Projektunterordner wirken sich auf den Namespace aus, in dem eingebettete Ressourcen gefunden werden.
Implementieren Sie die IProvideAttributeTable-Schnittstelle, um der Klasse des Steuerelements das ThumbnailAttribute hinzuzufügen. Sie können das gleiche Bild typenübergreifend wiederverwenden, indem Sie das gleiche ThumbnailAttribute für mehrere Steuerelemente übernehmen.

Das ThumbnailAttribute wird außerdem verwendet, um ein Standardsymbol für Typen zu finden, die zur Funktion für neue Instanzen des Auflistungs-Editors oder Untereigenschaften-Editors hinzugefügt wurden.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.