Icônes de boîte à outils
Vous pouvez inclure des icônes de boîte à outils à vos contrôles WPF et Silverlight personnalisés dans Visual Studio et Expression Blend. Cette rubrique explique comment nommer vos icônes de boîte à outils et comment les inclure en tant que ressources incorporées.
Types de fichiers pris en charge
La liste suivante répertorie les types de fichiers pris en charge pour les icônes de boîte à outils dans le Concepteur WPF pour Visual Studio.
BMP
GIF
JPG
JPEG
PNG
Notes
Expression Blend prend uniquement en charge les fichiers .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. Les outils de conception recherchent 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, et, dans la fenêtre Propriétés, définissez son Action de génération sur Ressource incorporée. 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
À des fins de compatibilité descendante, Visual Studio 2010 prend en charge la convention d'affectation des noms utilisée par Visual Studio 2008. Pour plus d'informations, consultez Icônes de boîte à outils dans Visual Studio 2008.
Visual Studio 2010 prend en charge la convention d'affectation de noms suivante pour les icônes de boîte à outils. Les sous-chaînes entre crochets ([]) sont facultatives.
[Chaîne]EspaceNoms.NomContrôle[.Produit][.Chaîne].Extension
Lorsqu'un concepteur recherche des icônes de boîte à outils, il associe les sous-chaînes EspaceNoms, NomContrôle et Produit. Si EspaceNoms et NomContrôle ne correspondent pas au contrôle, l'icône ne s'affiche pas dans la Boîte à outils.
La sous-chaîne Produit peut être utilisée par un concepteur pour filtrer des icônes pour d'autres produits. Ainsi, Visual Studio préfère les icônes dont Produit a la valeur « VisualStudio ».
La liste suivante présente des exemples de conventions d'affectation de noms des icônes de boîte à outils que vous pouvez utiliser pour les icônes Visual Studio et Expression Blend.
EspaceNoms.NomContrôle.VisualStudio.Extension
EspaceNoms.NomContrôle.VisualStudio.Chaîne.Extension
EspaceNoms.NomContrôle.Expression.png
EspaceNoms.NomContrôle.Expression.Chaîne.png
Si aucune icône n'est trouvée par rapport aux noms précédents, les noms suivants sont recherchés.
EspaceNoms.NomContrôle.Extension
EspaceNoms.NomContrôle.Chaîne.Extension
La liste suivante répertorie des exemples de noms d'icônes de boîte à outils pour un contrôle appelé TailspinToysControl dans l'espace de noms TailspinToysControlLibrary. Des informations facultatives supplémentaires sur le format d'image sont ajoutées, mais elles ne sont pas utilisées par les concepteurs.
TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp
TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png
Une fois qu'un concepteur a trouvé des icônes de boîte à outils, l'icône qui correspond le mieux à la taille d'icône cible du concepteur est chargée pour affichage. La liste suivante indique l'ordre dans lequel les critères de correspondance sont appliqués.
Sélectionnez les icônes ayant un concepteur spécifié dans leur nom plutôt que les icônes sans spécification de concepteur. Par exemple, le Concepteur WPF préfère les icônes possédant « VisualStudio » dans leur nom plutôt que celles possédant « Expression ».
Sélectionnez l'icône qui correspond le mieux à la taille de rendu. La Boîte à outils de Visual Studio charge l'icône la plus proche de 16x16 pixels, puis mappe cette icône sur la profondeur de couleur 24 bits.
Sélectionnez la première icône trouvée.
Substitution des icônes de boîte à outils par défaut
Vous pouvez utiliser l'infrastructure d'extensibilité Concepteur WPF pour substituer les icônes de boîte à outils incorporées dans l'assembly au moment de l'exécution d'un contrôle. Pour plus d'informations, consultez Procédure pas à pas : mise à disposition de métadonnées pour les icônes de boîte à outils.
Voir aussi
Concepts
Icônes de boîte à outils dans Visual Studio 2008
Autres ressources
Procédure pas à pas : mise à disposition de métadonnées pour les icônes de boîte à outils