Toolboxsymbole
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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
Hinweis
Expression Blend unterstützt nur PNG-Dateien.
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.
Hinweis
Für die Abwärtskompatibilität unterstützt Visual Studio 2010 die von Visual Studio 2008 verwendete Benennungskonvention.Weitere Informationen finden Sie unter Toolboxsymbole in Visual Studio 2008.
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.
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.
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.
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
Aufgaben
Exemplarische Vorgehensweise: Bereitstellen von Metadaten für Toolboxsymbole