Comment : créez un contrôle de boîte à outils qui utilise Windows Forms
Le modèle de contrôle de la boîte à outils Windows Forms qui est inclus dans Kit de développement logiciel Visual Studio 2010 vous permet de créer des contrôles Windows Forms qui sont ajoutés automatiquement à boîte à outils lorsque l'extension est installée. Cette rubrique montre comment utiliser le modèle pour créer un contrôle de boîte à outils que vous pouvez distribuer à d'autres utilisateurs. Pour une implémentation complète d'un contrôle de boîte à outils, consultez Procédure pas - à - pas : Créer un contrôle de boîte à outils Windows Forms.
Notes
Pour plus d'informations sur le kit de développement Visual Studio, consultez Étendre la présentation de Visual Studio.Pour savoir comment télécharger le kit de développement Visual Studio, consultez Visual Studio Extensibility Developer Center sur le site Web MSDN.
créer un contrôle de boîte à outils
Utilisez le modèle de contrôle de la boîte à outils Windows Forms pour créer le projet, puis générez une interface (UI) utilisateur dans le concepteur.
Pour créer un projet de contrôle de la boîte à outils Windows Forms
Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Dans la boîte de dialogue de Nouveau projet , sous Modèles installés, cliquez sur le nœud pour votre langage de programmation par défaut et cliquez sur Extensibilité. Dans la liste des types de projets, sélectionnez Contrôle de la boîte à outils Windows Forms.
Dans la zone de Nom , tapez le nom que vous souhaitez utiliser pour le projet. Cliquez sur OK.
Visual Studio crée une solution qui contient un contrôle utilisateur, un attribut pour mettre le contrôle dans boîte à outils, et un manifeste VSIX pour le déploiement.
Pour générer le contrôle interface utilisateur
Dans Explorateur de solutions, double-cliquez sur ToolboxControl.cs pour l'ouvrir dans le concepteur.
De boîte à outils, faites glisser les contrôles que vous souhaitez à l'aire de conception, et placez -les en fonction de votre conception.
dans la fenêtre de Propriétés , définissez les propriétés publiques sur le contrôle utilisateur et sur les contrôles enfants.
coder le contrôle
Par défaut, votre contrôle apparaîtra dans boîte à outils comme ToolboxControl1 à un groupe d'éléments de boîte à outils portant le même nom que votre solution. vous pouvez modifier ces noms dans le fichier de ToolboxControl.cs.
Pour ajouter du code au contrôle
Dans Explorateur de solutions, cliquez avec le bouton droit sur ToolboxControl.cs puis cliquez sur Afficher le code pour ouvrir le fichier dans l'éditeur de Code.
À la définition de la classe partielle qui implémente le contrôle, cliquez avec le bouton droit sur le nom de classe, cliquez sur Refactoriser, puis cliquez sur Renommer. Modifiez le nom de la classe le nom que vous souhaitez afficher dans boîte à outils lorsque le contrôle est installé.
Juste au-dessus de la définition de classe, dans la déclaration attribute d' ProvideToolboxControl , modifiez la valeur du premier paramètre le nom du groupe d'éléments devant héberger le contrôle dans boîte à outils.
L'exemple suivant montre l'attribut d' ProvideToolboxControl et la définition de classe réglée pour un contrôle nommé compteur dans le groupe d'éléments de Général .
[ProvideToolboxControl("General", false)] public partial class Counter : UserControlImplémentez des propriétés, des méthodes, et les événements du contrôle.
Génération, test, et déploiement
Appuyez sur F5 le projet, qui inclut un fichier de déploiement .vsix, et ouvre une deuxième instance de Visual Studio dans laquelle le contrôle installé dans boîte à outils.
Pour générer et tester le contrôle
Appuyez sur F5.
dans la nouvelle instance de Visual Studio, créez un projet d'application Windows Forms.
Recherchez votre contrôle dans boîte à outils et faites -le glisser sur l'aire de conception.
Dans la fenêtre de Propriétés , vérifiez que vos propriétés apparaissent comme prévu.
Ajoutez tous les codes ou autres contrôles qui sont requis pour tester vos méthodes et événements.
Appuyez sur F5 pour ouvrir une application Windows Forms.
vérifiez que les propriétés, les méthodes, et les événements de votre contrôle se comportent comme prévu.
pour déployer le contrôle
Après avoir généré le projet de test, ouvrez \bin\debug\ folder of the project in Windows Explorer et localisez le fichier .vsix.
Téléchargez le fichier .vsix à un réseau ou un site Web.
Si vous téléchargez le fichier Visual Studio Gallery au site Web, d'autres utilisateurs peuvent utiliser Gestionnaire d'extensions dans Visual Studio pour rechercher le contrôle et l'installer.
Voir aussi
Tâches
Procédure pas - à - pas : Créer un contrôle de boîte à outils Windows Forms
Comment : créez un contrôle de boîte à outils qui utilise WPF