Toolboxsymbole

Sie können Toolboxsymbole in die benutzerdefinierten WPF- und Silverlight-Steuerelemente in Visual Studio und Expression Blend einschließen. In diesem Thema wird beschrieben, wie die Toolboxsymbole benannt werden und wie sie als eingebettete Ressourcen aufgenommen werden.

Unterstützte Dateitypen

In der folgenden Liste werden die unterstützten Dateitypen für Toolboxsymbole im WPF Designer für Visual Studio aufgeführt. 

• BMP

• GIF

• JPG

• JPEG

• PNG

Namenskonvention

Sie ordnen einem benutzerdefinierten Steuerelement ein Toolboxsymbol zu, indem Sie eine Namenskonvention befolgen. Entwurfstools prüfen die eingebetteten Ressourcen in der Assembly des Steuerelements auf eine entsprechend benannte Bilddatei.

Im einfachsten Fall fügen Sie die Bilddatei mit dem Toolboxsymbol als eingebettete Ressource dem Projekt des Steuerelements hinzu. Benennen Sie sie Steuerelementname.Erweiterung, und legen Sie im Eigenschaftenfenster den Buildvorgang auf Eingebettete Ressource fest. Der WPF-Designer sucht nach einer Ressource mit einem Dateinamen, der mit dem Typnamen des Steuerelements übereinstimmt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Toolboxsymbols für ein Steuerelement.

Visual Studio 2010 unterstützt die folgende Benennungskonvention für Toolboxsymbole. Die Teilzeichenfolgen in eckigen Klammern ([]) sind optional.

[Zeichenfolge]Namespace.Steuerelementname[.Produkt] [.Zeichenfolge].Erweiterung

Wenn ein Designer nach Toolboxsymbolen sucht, werden die Teilzeichenfolgen Namespace, Steuerelementname und Produkt abgeglichen. Wenn Namespace und Steuerelementname nicht mit dem Steuerelement übereinstimmen, wird das Symbol in der Toolbox nicht angezeigt.

Die Teilzeichenfolge Produkt kann von einem Designer verwendet werden, um Symbole für andere Produkte herauszufiltern. Visual Studio bevorzugt z. B. Symbole, bei denen Produkt auf "VisualStudio" festgelegt ist.

Die folgende Liste zeigt Beispiele zu Benennungskonventionen für Toolboxsymbole, die Sie für Visual Studio- und Expression Blend-Symbole verwenden können.

• Namespace.Steuerelementname.VisualStudio.Erweiterung

• Namespace.Steuerelementname.VisualStudio.Zeichenfolge.Erweiterung

• Namespace.Steuerelementname.Expression.png

• Namespace.Steuerelementname.Expression.Zeichenfolge.png

Wenn keine Symbole gefunden werden, die zu den zuvor genannten Namen passen, wird nach den folgenden Namen gesucht.

• Namespace.Steuerelementname.Erweiterung

• Namespace.Steuerelementname.Zeichenfolge.Erweiterung

Die folgende Liste zeigt Beispiele von Toolboxsymbolnamen für ein Steuerelement mit dem Namen TailspinToysControl im TailspinToysControlLibrary-Namespace an. Zusätzliche optionale Informationen zum Bildformat werden hinzugefügt, aber nicht von Designern verwendet.

• TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

• TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

Wenn ein Designer Toolboxsymbole findet, wird das Symbol, das der Zielsymbolgröße des Designers am besten entspricht, für die Anzeige geladen. Die folgende Liste zeigt die Reihenfolge, in der Kriterien für den Abgleich angewendet werden.

1. Auswählen von Symbolen, bei denen im Symbolnamen der Designer angegeben ist, vor Symbolen ohne einen Designer. Der WPF-Designer zieht z. B. Symbole, die "VisualStudio" im Namen haben, Symbolen mit "Expression" im Namen vor.

2. Auswählen des Symbols, das der Renderinggröße am besten entspricht. Die Visual Studio-Toolbox lädt das Symbol, das der Größe von 16 x 16 Pixeln am nächsten kommt, und ordnet dann diesem Symbol die 24-Bit-Farbtiefe zu.

3. Auswählen des Symbols, das zuerst gefunden wird.

Überschreiben von Standardtoolboxsymbolen

Sie können mit dem Framework der WPF-Designer-Erweiterbarkeit Toolboxsymbole überschreiben, die in die Laufzeitassembly eines Steuerelements eingebettet sind. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Bereitstellen von Metadaten für Toolboxsymbole.

Siehe auch

Konzepte

Toolboxsymbole in Visual Studio 2008

Weitere Ressourcen

Exemplarische Vorgehensweise: Bereitstellen von Metadaten für Toolboxsymbole