Procédure pas à pas : création d'une icône de boîte à outils personnalisée pour un contrôle

Mise à jour : novembre 2007

Cette procédure pas à pas indique comment créer une icône de boîte à outils pour un contrôle personnalisé WPF (Windows Presentation Foundation). Lorsque vous ajoutez le contrôle personnalisé à la boîte à outils, cette icône s'affiche en regard du nom du contrôle.

Dans cette procédure pas à pas, vous exécutez les tâches suivantes :

• créer un projet de bibliothèque de contrôles personnalisés WPF ;

• créer un fichier bitmap personnalisé pour l'icône de boîte à outils du contrôle ;

• tester le contrôle au moment du design ;

Lorsque vous aurez terminé, vous saurez comment créer une icône de boîte à outils pour un contrôle personnalisé.

Remarque :
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Composants requis

Vous avez besoin des composants suivants pour exécuter cette procédure pas à pas :

• Visual Studio 2008.

Création d'une icône de boîte à outils personnalisée

Pour créer une icône de boîte à outils personnalisée pour un contrôle, ajoutez une image en tant que ressource incorporée au projet du contrôle.

Pour créer une icône de boîte à outils personnalisée

1. Créez un projet de bibliothèque de contrôles personnalisés WPF dans Visual Basic ou Visual C# nommé CustomControlWithToolboxIcon.

   Le code pour CustomControl1 s'ouvre dans l'éditeur de code.

2. Dans le menu Projet, sélectionnez Ajouter un nouvel élément.

   La boîte de dialogue Ajouter un nouvel élément s'ouvre.

3. Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez la catégorie Général.

4. Dans le volet Modèles, sélectionnez Fichier bitmap, nommez le nouveau fichier CustomControl1.Icon.bmp, puis cliquez sur Ajouter. L'Éditeur d'images s'ouvre alors.

5. Dans la fenêtre Propriétés, affectez la valeur 24 bits à la propriété Couleurs de la bitmap.

6. Utilisez les outils de l'Éditeur d'images pour peindre une image dans la bitmap. Pour plus d'informations, consultez Éditeur d'images.

7. Dans l'Explorateur de solutions, sélectionnez CustomControl1.Icon.bmp.

8. Dans la fenêtre Propriétés, affectez la valeur Ressource incorporée à la propriété Action de génération.

9. Générez la solution.

   Pour plus d'informations, consultez Icônes de boîte à outils et ressources incorporées.

Test de l'icône de boîte à outils

Testez votre icône de boîte à outils personnalisée en ajoutant CustomControl1 à la boîte à outils.

Pour tester l'icône de boîte à outils

1. Ajoutez à la solution un nouveau projet d'application WPF dans Visual Basic ou Visual C# nommé TestApplication.

   Window1.xaml s'ouvre dans le Concepteur WPF.

2. Ajoutez une référence au projet CustomControlWithToolboxIcon.

3. Cliquez avec le bouton droit sur la boîte à outils et, dans le menu contextuel, cliquez sur Choisir les éléments.

   La boîte de dialogue Choisir des éléments de boîte à outils s'affiche.

4. Dans la boîte de dialogue Choisir des éléments de boîte à outils, cliquez sur l'onglet Composants WPF. Pour plus d'informations, consultez Composants WPF, onglet de la boîte de dialogue Choisir des éléments de boîte à outils.

5. Cliquez sur Parcourir et accédez au dossier bin\Debug du projet CustomControlWithToolboxIcon.

6. Double-cliquez sur le fichier CustomControlWithToolboxIcon.dll pour le sélectionner.

   Les détails de l'assembly CustomControlWithToolboxIcon s'affichent dans la boîte de dialogue Choisir des éléments de boîte à outils. Votre icône personnalisée s'affiche dans la zone de groupe CustomControl1.

7. Cliquez sur OK.

   CustomControl1 s'affiche dans la boîte à outils avec l'icône correspondante.

Voir aussi

Tâches

Comment : incorporer une icône dans un assembly

Concepts

Icônes de boîte à outils et ressources incorporées

Autres ressources

Concepts d'extensibilité de base