Sdílet prostřednictvím


ThumbnailAttribute-Klasse

Aktualisiert: Juli 2008

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

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

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute
'Usage
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

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.

  1. Erstellen Sie eine Entwurfszeit-Metadatenassembly für das benutzerdefinierte Steuerelement. Weitere Informationen hierzu finden Sie unter Gewusst wie: Verwenden des Metadatenspeichers.

  2. 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.

  3. Legen Sie im Eigenschaftenfenster den Buildvorgang für das Bild auf EmbeddedResource fest.

    Hinweis:

    Die Projektunterordner wirken sich auf den Namespace aus, in dem eingebettete Ressourcen gefunden werden.

  4. Verwenden Sie den Metadatenspeicher, um das ThumbnailAttribute zur Klasse Ihres Steuerelements 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 der neuen Instanz des Auflistungs-Editors oder Untereigenschaften-Editors hinzugefügt wurden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe des MetadataStore das ThumbnailAttribute zu einem benutzerdefinierten Silverlight-Steuerelement hinzugefügt wird.

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());
    }
} 

Vererbungshierarchie

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

Threadsicherheit

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

Siehe auch

Referenz

ThumbnailAttribute-Member

Microsoft.Windows.Design-Namespace

ToolboxBrowsableAttribute

Änderungsprotokoll

Date

Versionsgeschichte

Grund

Juli 2008

Thema für neue Klasse hinzugefügt.

SP1-Featureänderung.