Procédure pas à pas : remplissage automatique de la boîte à outils avec des composants personnalisés
Si vos composants sont définis par un projet dans la solution actuellement ouverte, ils apparaissent automatiquement dans la boîte à outils , sans aucune action requise par vous. Vous pouvez également remplir manuellement la boîte à outils avec vos composants personnalisés à l’aide de la boîte de dialogue Choisir des éléments de boîte à outils (Visual Studio), mais la boîte à outils prend en compte les éléments dans les sorties de build de votre solution avec toutes les caractéristiques suivantes :
Implémente IComponent ;
Ne dispose pas de ToolboxItemAttribute défini sur
false;Ne dispose pas de DesignTimeVisibleAttribute défini sur
false.
Note
La boîte à outils ne suit pas les chaînes de référence. Elle n’affiche donc pas les éléments qui ne sont pas générés par un projet dans votre solution.
Cette procédure pas à pas montre comment un composant personnalisé apparaît automatiquement dans la boîte à outils une fois le composant généré. Les tâches illustrées dans cette procédure pas à pas sont les 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 verrez que la boîte à outils est remplie avec un composant que vous avez créé.
Créer le projet
Dans Visual Studio, créez un projet d’application Windows appelé
ToolboxExample(File>New>Project>Visual C# ou Visual Basic>Classic Desktop>Application Windows Forms).Ajoutez un nouveau composant au projet. Appelez-le
DemoComponent.Pour plus d’informations, consultez Comment : Ajouter de nouveaux éléments de projet.
Construisez le projet.
Depuis 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 est définie sur Vrai.
Créer une instance d’un composant personnalisé
L’étape suivante consiste à créer une instance du composant personnalisé sur le formulaire. Étant donné que la boîte à outils compte automatiquement pour le nouveau composant, c’est aussi facile que la création d’un autre composant ou contrôle.
Ouvrez le formulaire du projet dans le concepteur de formulaires .
Dans la Boîte à outils, cliquez sur le nouvel onglet appelé Composants ToolboxExample.
Une fois que vous cliquez sur l’onglet, vous verrez DemoComponent.
Note
Pour des raisons de performances, les composants de la zone renseignée automatiquement 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 du composant.
Déchargez et rechargez un composant personnalisé
La boîte à outils prend en compte les composants de chaque projet chargé et lorsqu’un projet est déchargé, il supprime les références aux composants du projet.
Déchargez le projet à partir 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 d'application Windows à la solution. Ouvrez le formulaire dans le Concepteur.
L’onglet ToolboxExample Components du projet précédent est maintenant disparu.
Rechargez le projet
ToolboxExample.L’onglet ToolboxExample Components réapparaît désormais.
Étapes suivantes
Cette procédure pas à pas montre que la boîte à outils tient compte des composants d’un projet, mais que la boîte à outils tient également compte des contrôles. Expérimentez vos propres contrôles personnalisés en ajoutant et en supprimant des projets de contrôle de votre solution.