Procédure pas à pas : remplissage automatique de la boîte à outils avec des composants personnalisés
Mise à jour : novembre 2007
Si vos composants sont définis par un projet dans la solution actuellement ouverte, ils apparaîtront automatiquement dans la Boîte à outils, sans intervention de votre part. Vous pouvez également remplir manuellement la Boîte à outils avec vos composants personnalisés en utilisant le Choisir des éléments de boîte à outils, boîte de dialogue (Visual Studio), mais la Boîte à outils tient compte, dans les sorties de génération de votre solution, des éléments ayant toutes les caractéristiques suivantes :
Implémente IComponent ;
N'a pas ToolboxItemAttribute défini avec la valeur false ;
N'a pas DesignTimeVisibleAttribute défini avec la valeur false.
.gif "Remarque") Remarque : |
|---|
La Boîte à outils ne suit pas de chaînes de référence ; elle n'affiche donc pas les éléments qui ne sont pas construits par un projet dans votre solution. |
Cette procédure pas à pas montre comment un composant personnalisé peut apparaître automatiquement dans la Boîte à outils une fois le composant créé. Cette procédure pas à pas illustre les tâches suivantes :
Création d'un projet Windows Forms.
Création d'un composant personnalisé.
Création d'une instance d'un composant personnalisé.
Déchargement et rechargement d'un composant personnalisé.
Lorsque vous avez terminé, vous constatez que la Boîte à outils est remplie avec un composant que vous avez créé.
| Remarque : |
|---|
Selon vos paramètres actifs ou votre édition, les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide. 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. |
Création du projet
La première étape consiste à créer le projet et à configurer le formulaire.
Pour créer le projet
Créez un projet d'application Windows appelé ToolboxExample.
Pour plus d'informations, consultez Comment : créer un projet d'application Windows.
Ajoutez un nouveau composant au projet. Appelez-le DemoComponent.
Pour plus d'informations, consultez Comment : ajouter de nouveaux éléments de projet.
Générez le projet.
Dans le menu Outils, cliquez sur l'élément Options. Cliquez sur Général sous l'élément Concepteur Windows Forms et vérifiez que l'option AutoToolboxPopulate a la valeur True.
Création d'une instance d'un composant personnalisé
L'étape suivante consiste à créer une instance du composant personnalisé sur le formulaire. Dans la mesure où la Boîte à outils tient automatiquement compte du nouveau composant, cette approche est aussi facile à mettre en œuvre que la création de n'importe quel autre composant ou contrôle.
Pour créer une instance d'un composant personnalisé
Ouvrez le formulaire du projet dans le Concepteur Forms.
Dans la Boîte à outils, cliquez sur le nouvel onglet nommé Composants ToolboxExample.
Une fois que vous cliquez sur l'onglet, DemoComponent apparaît.
Remarque :Pour des raisons de performances, les composants dans la zone à remplissage automatique de la Boîte à outils n'affichent pas de bitmaps personnalisées, et le ToolboxBitmapAttribute n'est pas pris en charge. Pour afficher une icône pour un composant personnalisé dans la Boîte à outils, utilisez la boîte de dialogue Choisir des éléments de boîte à outils pour charger votre composant.
Faites glisser votre composant sur votre formulaire.
Une instance du composant est créée et ajoutée à la barre d'état des composants.
Déchargement et rechargement d'un composant personnalisé
La Boîte à outils tient compte des composants dans chaque projet chargé, et lorsqu'un projet est déchargé, elle supprime les références aux composants du projet.
Pour tester l'effet de déchargement et de rechargement des composants sur la Boîte à outils
Déchargez le projet de la solution.
Pour plus d'informations sur le déchargement de projets, consultez Comment : décharger et recharger des projets. Si vous êtes invité à enregistrer, choisissez Oui.
Ajoutez un nouveau projet Application Windows à la solution. Ouvrez le formulaire dans le concepteur.
L'onglet Composants ToolboxExample du projet précédent a maintenant disparu.
Rechargez le projet ToolboxExample.
L'onglet Composants ToolboxExample réapparaît maintenant.
Étapes suivantes
Cette procédure pas à pas montre que la Boîte à outils prend compte les composants d'un projet, mais la Boîte à outils tient également compte des contrôles. Essayez avec vos propres contrôles personnalisés en ajoutant et supprimant des projets de contrôle de votre solution.
Voir aussi
Tâches
Comment : manipuler des onglets de boîte à outils
Référence
Général, Concepteur Windows Forms, boîte de dialogue Options
Choisir des éléments de boîte à outils, boîte de dialogue (Visual Studio)