Partager via

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

  • Article

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 allez effectuer 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 l'icône du 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é.

Notes

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 Utilisation des paramètres.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

  • Visual Studio 2010.

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 en 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 la liste de 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.

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 en Visual Basic ou Visual C# nommé TestApplication.

    MainWindow.xaml s'ouvre dans le Concepteur WPF. Dans la Boîte à outils, CustomControl1 s'affiche dans l'onglet Contrôles CustomControlWithToolboxIcon.

    Boîte à outils avec contrôle personnalisé

  2. Dans la Boîte à outils, cliquez avec le bouton droit sur CustomControl1 et sélectionnez Supprimer.

  3. Dans la boîte de message qui apparaît, cliquez sur OK.

    CustomControl1 est supprimé de la Boîte à outils.

  4. Dans la Boîte à outils, cliquez avec le bouton droit sur le groupe de contrôles où vous souhaitez ajouter le contrôle, puis sélectionnez Choisir les éléments dans le menu contextuel.

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

  5. 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.

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

  7. Dans la boîte de dialogue Ouvrir, sélectionnez CustomControlWithToolboxIcon.dll et cliquez sur Ouvrir.

    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.

  8. Cliquez sur OK.

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

    Icône de boîte à outils personnalisée

Voir aussi

Tâches

Comment : incorporer une icône dans un assembly

Référence

Composants WPF, onglet de la boîte de dialogue Choisir des éléments de boîte à outils

Autres ressources

Icônes de boîte à outils

Utilisation des ressources

Procédure pas à pas : mise à disposition de métadonnées pour les icônes de boîte à outils