Icônes de boîte à outils dans Visual Studio 2008

Article
08/10/2011

Vous pouvez inclure des icônes de boîte à outils à vos contrôles Windows Presentation Foundation (WPF) personnalisés dans Visual Studio. Cette rubrique explique comment nommer vos icônes de boîte à outils et comment les inclure en tant que ressources incorporées.

Notes

Cette rubrique est conservée pour compatibilité descendante avec Visual Studio 2008. Pour Visual Studio 2010, consultez Icônes de boîte à outils.

Types de fichiers pris en charge

Le tableau suivant répertorie les types de fichiers pris en charge pour les icônes de boîte à outils dans le Concepteur WPF pour Visual Studio.

XAML
BMP
GIF
JPG
JPEG
PNG

Convention d'affectation de noms

Pour associer une icône de boîte à outils à un contrôle personnalisé, vous devez respecter une convention d'affectation de noms. En effet, le Concepteur WPF pour Visual Studio recherche un fichier image correctement nommé dans les ressources incorporées de l'assembly du contrôle.

Dans le plus simple des cas, vous ajoutez le fichier image de l'icône de boîte à outils en tant que ressource incorporée au projet de votre contrôle. Nommez-le NomContrôle.Extension. Le Concepteur WPF recherche une ressource dont le nom de fichier correspond au nom de type du contrôle. Pour plus d'informations, consultez Procédure pas à pas : création d'une icône de boîte à outils personnalisée pour un contrôle.

Notes

Le Concepteur WPF utilise un algorithme de correspondance pour rechercher la meilleure ressource pour une icône de boîte à outils. Si un fichier de ressources n'est pas du code XAML valide ou un fichier image valide, la correspondance suivante est utilisée jusqu'à ce qu'un élément valide soit trouvé. Les images XAML ne peuvent pas contenir de références à des types non-système.

Nom à correspondance complète

La convention d'affectation de noms des icônes de boîte à outils prend en charge les noms de ressources à correspondance complète. En ce qui concerne ces noms, vous incluez l'espace de noms dans le nom d'icône de boîte à outils en respectant la convention suivante : EspaceNoms.NomContrôle.Icon.Extension. Prenons l'exemple d'un contrôle nommé ProseControl et défini dans l'espace de noms Proseware.Core.Controls. Pour ce contrôle, une icône de boîte à outils PNG à correspondance complète serait nommée Proseware.Core.Controls.ProseControl.Icon.png.

Pour les ressources, Visual Studio convertit automatiquement les dossiers en espaces de noms. Par conséquent, vous pouvez créer une structure de dossiers dans le projet qui est identique à l'espace de noms. Notez que les dossiers affectent l'espace de noms qui contient les ressources incorporées. Dans l'exemple précédent, si le fichier image est situé dans un sous-dossier nommé Icons, le Concepteur WPF recherche une icône de boîte à outils nommée Proseware.Core.Controls.Icons.ProseControl.Icon.png.

Si une image est introuvable dans le même espace de noms que le contrôle, le Concepteur WPF recherche une correspondance partielle.

Nom à correspondance partielle

Si le Concepteur WPF ne trouve pas de ressource à correspondance complète, il recherche des correspondances partielles dans les ressources incorporées de l'assembly. Dans l'exemple précédent, le Concepteur WPF recherche d'abord un fichier qui porte le nom à correspondance complète Proseware.Core.Controls.ProseControl.Icon.Extension. Si cette recherche échoue, le Concepteur WPF ignore l'espace de noms et effectue une recherche en fonction du nom de type seulement. Dans cet exemple, le Concepteur WPF recherche des fichiers dans les ressources nommés ProseControl.Icon.Extension. Si cette recherche échoue, le Concepteur WPF lance une recherche à partir de l'espace de noms par défaut. Dans cet exemple, le Concepteur WPF recherche des fichiers nommés Proseware.ProseControl.Icon.Extension.

Tailles d'image multiples

Le nom du fichier image de l'icône de boîte à outils peut inclure un champ « Icon » facultatif. Cette sous-chaîne permet de spécifier plusieurs tailles d'image pour l'icône.

Pour le contrôle ProseControl de l'exemple précédent, le Concepteur WPF recherche les images suivantes dans les ressources et sélectionne la meilleure correspondance pour la taille.

Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png

Vous pouvez également omettre le point qui suit « Icon » afin de spécifier les noms de fichiers suivants.

Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png

Le Concepteur WPF sélectionne l'icône de boîte à outils en fonction des règles suivantes.

Code XAML vectoriel.
Correspondance exacte sur la taille dans les deux dimensions.
Correspondance la plus proche en fonction de la taille et des proportions.

La taille d'image recommandée pour les formats de fichier bitmap est de 64 pixels par 64 pixels.

Le Concepteur WPF et Expression Blend utilisent des tailles d'image différentes pour l'icône de boîte à outils. En effet, Expression Blend utilise le format 24 x 24 pour la grande taille d'icône et 12 x 12 pour la petite taille, tandis que le Concepteur WPF utilise le format 16 x 16.

Si la taille souhaitée par l'hôte est de 64 x 64 pixels et que Proseware.Core.Controls.ProseControl.Icon.Large.png est la meilleure correspondance en taille et en proportions, ce fichier est utilisé. Toutes les images de l'assembly sont examinées. Si deux images présentent une taille et des proportions identiques, l'hôte détermine laquelle il utilise.