Procédure pas à pas : remplissage automatique de la boîte à outils avec des composants personnalisés

  • Article

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 :

Remarque

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é. Cette procédure pas à pas décrit notamment 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 verrez que la boîte à outils est remplie avec un composant que vous avez créé.

Créer le projet

  1. Dans Visual Studio, créez un projet d’application Windows appelé ToolboxExample (Application>>Windows Forms de nouveau projet>ou Visual Basic>Classic Desktop>Windows Forms).

  2. Ajoutez un nouveau composant au projet. Appelez-le DemoComponent.

    Pour plus d’informations, consultez Guide pratique pour ajouter de nouveaux éléments de projet.

  3. Créez le projet.

  4. 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é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, il s’agit aussi facile que de créer n’importe quel autre composant ou contrôle.

  1. Ouvrez le formulaire du projet dans le Concepteur de formulaires.

  2. Dans la boîte à outils, cliquez sur le nouvel onglet appelé ToolboxExample Components.

    Une fois que vous cliquez sur l’onglet, vous verrez DemoComponent.

    Remarque

    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 ne sont ToolboxBitmapAttribute 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.

  3. Faites glisser votre composant sur votre formulaire.

    Une instance du composant est créée et ajoutée à la barre d’état du composant.

Décharger et recharger 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.

  1. Déchargez le projet à partir de la solution.

    Pour plus d’informations sur le déchargement de projets, consultez Guide pratique pour décharger et recharger des projets. Si vous êtes invité à enregistrer, choisissez Oui.

  2. Ajoutez un nouveau projet d’application Windows à la solution. Ouvrez le formulaire dans le Concepteur.

    L’onglet Components ToolboxExample du projet précédent est maintenant disparu.

  3. Rechargez le ToolboxExample projet.

    L’onglet Composants De Boîte à outilsExample réapparaît désormais.

Étapes suivantes

Cette procédure pas à pas montre que la boîte à outils prend en compte les composants d’un projet, mais que la boîte à outils prend également en compte les contrôles. Expérimentez vos propres contrôles personnalisés en ajoutant et en supprimant des projets de contrôle de votre solution.

Voir aussi