Toolboxsymbole in Visual Studio 2008
Sie können Toolboxsymbole in die benutzerdefinierten WPF-Steuerelemente (Windows Presentation Foundation) in Visual Studio aufnehmen. In diesem Thema wird beschrieben, wie die Toolboxsymbole benannt werden und wie sie als eingebettete Ressourcen aufgenommen werden.
Tipp
Dieses Thema bleibt aufgrund der Abwärtskompatibilität mit Visual Studio 2008 erhalten. Entsprechende Informationen zu Visual Studio 2010 finden Sie unter Toolboxsymbole.
Unterstützte Dateitypen
In der folgenden Tabelle werden die unterstützten Dateitypen für Toolboxsymbole im WPF Designer für Visual Studio aufgeführt.
XAML
BMP
GIF
JPG
JPEG
PNG
Namenskonvention
Sie ordnen einem benutzerdefinierten Steuerelement ein Toolboxsymbol zu, indem Sie eine Namenskonvention befolgen. Der WPF Designer für Visual Studio prüft 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. Nennen Sie die Datei ControlName.Extension. 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.
Tipp
Der WPF-Designer verwendet einen Vergleichsalgorithmus, um die beste Ressource für ein Toolboxsymbol zu suchen. Wenn eine Ressourcendatei keine gültige XAML- oder Bilddatei ist, wird die nächste Übereinstimmung verwendet, bis eine passende Datei gefunden wird. XAML-Bilder können keine Verweise auf Nicht-Systemtypen enthalten.
Name mit vollständiger Übereinstimmung
Die Namenskonvention für Toolboxsymbole unterstützt Ressourcennamen mit vollständiger Übereinstimmung. Für Namen mit vollständiger Übereinstimmung nehmen Sie den Namespace in den Namen des Toolboxsymbols auf, indem Sie folgende Konvention verwenden: Namespace.ControlName.Icon.Extension. Nehmen Sie als Beispiel ein Steuerelement mit dem Namen ProseControl, das im Proseware.Core.Controls-Namespace definiert wird. Ein PNG-Toolboxsymbol mit vollständiger Übereinstimmung für dieses Steuerelement würde Proseware.Core.Controls.ProseControl.Icon.png genannt werden.
Für Ressourcen konvertiert Visual Studio Ordner automatisch in Namespaces. Daher können Sie eine Ordnerstruktur im Projekt erstellen, die mit dem Namespace identisch ist. Beachten Sie, dass sich Ordner auf den Namespace auswirken, in dem eingebettete Ressourcen gefunden werden. Im vorherigen Beispiel würde der WPF-Designer nach einem Toolboxsymbol mit dem Namen "Proseware.Core.Controls.Icons.ProseControl.Icon.png" suchen, wenn sich die Bilddatei im Unterordner "Icons" befindet.
Wenn im selben Namespace wie das Steuerelement kein Bild gefunden wird, sucht der WPF-Designer nach einer niedrigen Übereinstimmung.
Name mit niedriger Übereinstimmung
Wenn der WPF-Designer keine Ressource mit vollständiger Übereinstimmung findet, sucht er in der eingebetteten Ressource nach niedrigen Übereinstimmungen. Im vorherigen Beispiel sucht der WPF-Designer zunächst nach einer Datei mit dem vollständig übereinstimmenden Namen Proseware.Core.Controls.ProseControl.Icon.Extension. Schlägt diese Suche fehl, ignoriert der WPF-Designer den Namespace und sucht lediglich anhand des Typnamens nach einem Namen. In diesem Beispiel sucht der WPF-Designer nach allen Dateien in den Ressourcen mit dem Namen "ProseControl.Icon.xtension". Schlägt diese Suche fehl, beginnt der WPF-Designer die Suche im Standardnamespace. In diesem Beispiel sucht der WPF-Designer nach Dateien mit dem Namen Proseware.ProseControl.Icon.Extension.
Mehrere Bildgrößen
Der Bilddateinamen des Toolboxsymbols enthält möglicherweise ein optionales "Symbol"-Feld. Diese Teilzeichenfolge ermöglicht es, mehrere Bildgrößen für das Symbol anzugeben.
Für das ProseControl-Steuerelement im vorherigen Beispiel sucht der WPF-Designer die folgenden Bilder in den Ressourcen und wählt die beste Übereinstimmung im Hinblick auf die Größe aus.
Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png
Sie können den Punkt, der auf "Icon" folgt, auch weglassen, um die folgenden Dateinamen anzugeben.
Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png
Der WPF-Designer wählt das Toolboxsymbol anhand der folgenden Regeln aus.
Vektor-XAML.
Genaue Übereinstimmung der Größe in beiden Dimensionen.
Engste Übereinstimmung anhand von Größe und Seitenverhältnis.
Die empfohlene Bildgröße für bitmapbasierte Dateiformate ist 64 Pixel mal 64 Pixel.
Der WPF-Designer und Expression Blend verwenden verschiedene Bildgrößen für das Toolboxsymbol. Expression Blend verwendet 24x24 für die große Symbolgröße und 12x12 für die kleine Größe. Der WPF-Designer verwendet 16x16.
Wenn die vom Host gewünschte Größe 64x64 Pixel ist und Proseware.Core.Controls.ProseControl.Icon.Large.png die beste Übereinstimmung im Hinblick auf Größe und Seitenverhältnis ist, wird diese Datei verwendet. Alle Bilder in der Assembly werden untersucht. Wenn zwei Bilder mit derselben Größe und demselben Seitenverhältnis vorhanden sind, entscheidet der Host, welches Bild er verwendet.