Comment : créer des contrôles composites

Article
08/10/2011

Les contrôles composites peuvent être utilisés de multiples façons. Vous pouvez les créer dans un projet d'application bureautique Windows et les utiliser seulement dans les formulaires de ce projet. Vous pouvez également les créer dans un projet Bibliothèque de contrôles Windows, compiler le projet pour créer un assembly et utiliser les contrôles dans d'autres projets. Vous pouvez même hériter d'eux et utiliser l'héritage visuel pour les personnaliser rapidement en fonction de vos besoins spécifiques.

Notes

Si vous souhaitez créer un contrôle composite à utiliser sur les Web Forms, consultez Développement de contrôles serveur ASP.NET personnalisés.

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.

Pour créer un contrôle composite

Ouvrez un nouveau projet Application Windows appelé DemoControlHost.
Dans le menu Projet, cliquez sur Ajouter un contrôle utilisateur.
Dans la boîte de dialogue Ajouter un nouvel élément, donnez au fichier de classe (fichier .vb ou .cs) le nom que vous souhaitez attribuer au contrôle composite.
Cliquez sur le bouton Ajouter pour créer le fichier de classe pour le contrôle composite.
Ajoutez à la surface du contrôle composite des contrôles provenant de la Boîte à outils.
Insérez du code dans des procédures événementielles afin de gérer les événements déclenchés par le contrôle composite ou par les contrôles le constituant.
Fermez le concepteur pour le contrôle composite et enregistrez le fichier lorsque vous y êtes invité.
Dans le menu Générer, cliquez sur Générer la solution.

Le projet doit être généré pour que les contrôles personnalisés apparaissent dans la Boîte à outils.
Utilisez l'onglet DemoControlHost de la Boîte à outils pour ajouter des instances de votre contrôle à Form1.

Pour créer une bibliothèque de classes de contrôle

Ouvrez un nouveau projet Bibliothèque de contrôles Windows.

Par défaut, le projet contient un contrôle composite.
Ajoutez des contrôles et du code en suivant la procédure décrite ci-dessus.
Sélectionnez un contrôle dont vous ne voulez pas modifier les classes qui héritent et définissez sa propriété Modifiers en lui donnant la valeur Private.
Générez la DLL.

Pour hériter d'un contrôle composite issu d'une bibliothèque de classes de contrôle

Dans le menu Fichier, pointez sur Ajouter, puis sélectionnez Nouveau projet pour ajouter un nouveau projet Application Windows à la solution.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier Références pour le nouveau projet et sélectionnez Ajouter la référence pour ouvrir la boîte de dialogue Ajouter la référence.
Sélectionnez l'onglet Projets et double-cliquez sur votre projet de bibliothèque de contrôles.
Dans le menu Générer, cliquez sur Générer la solution.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur votre projet de bibliothèque de contrôles et sélectionnez Ajouter un nouvel élément dans le menu contextuel.
Sélectionnez le modèle Contrôle utilisateur hérité dans la boîte de dialogue Ajouter un nouvel élément.
Dans la boîte de dialogue Sélecteur d'héritage, double-cliquez sur le contrôle dont vous voulez hériter.

Un nouveau contrôle est ajouté au projet.
Ouvrez le Concepteur visuel pour le nouveau contrôle et ajoutez les contrôles constitutifs requis.

Vous pouvez voir les contrôles constitutifs hérités du contrôle composite de votre DLL et modifier les propriétés de ceux dont la propriété Modifiers a la valeur Public. Vous ne pouvez pas modifier les propriétés d'un contrôle dont la propriété Modifiers a la valeur Private.