Procédure pas à pas : démonstration de l'héritage visuel

Article
10/18/2023

L'héritage visuel vous permet de visualiser les contrôles sur le formulaire de base et d'ajouter de nouveaux contrôles. Dans cette procédure pas à pas, vous allez créer un formulaire de base et le compiler dans une bibliothèque de classes. Vous importerez cette bibliothèque de classes dans un autre projet et créerez un formulaire qui hérite du formulaire de base. Pendant cette procédure pas à pas, vous allez apprendre à :

créer un projet de bibliothèque de classes contenant un formulaire de base ;
ajouter un bouton avec des propriétés modifiables par les classes dérivées du formulaire de base ;
ajouter un bouton qui ne peut pas être modifié par les héritiers du formulaire de base ;
créer un projet contenant un formulaire qui hérite de BaseForm.

Pour finir, cette procédure pas à pas vous montrera la différence entre les contrôles privés et protégés dans un formulaire hérité.

Attention

Les contrôles ne prennent pas tous en charge l'héritage visuel à partir d'un formulaire de base. Les contrôles suivants ne prennent pas en charge le scénario décrit dans cette procédure pas à pas :

Ces contrôles dans le formulaire hérité sont toujours en lecture seule, quels que soient les modificateurs que vous utilisez (private, protected ou public).

Créer un projet de bibliothèque de classes contenant un formulaire de base

Dans Visual Studio, dans le menu Fichier, choisissez Nouveau>projet pour ouvrir la boîte de dialogue Nouveau projet.
Créez une application Windows Forms nommée BaseFormLibrary.
Pour créer une bibliothèque de classes au lieu d’une application Windows Forms standard, dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet BaseFormLibrary, puis sélectionnez Propriétés.
Dans les propriétés du projet, remplacez le type de sortie de l’application Windows par bibliothèque de classes.
Dans le menu Fichier , choisissez Enregistrer tout pour enregistrer le projet et les fichiers à l’emplacement par défaut.

Les deux procédures suivantes ajoutent des boutons au formulaire de base. Pour illustrer l'héritage visuel, donnez aux boutons différents niveaux d'accès en définissant leurs propriétés Modifiers.

Ajouter un bouton qui hérite du formulaire de base peut modifier

Ouvrez Form1 dans le concepteur.
Sous l’onglet Tous les Windows Forms de la boîte à outils, double-cliquez sur Bouton pour ajouter un bouton au formulaire. Utilisez la souris pour positionner et redimensionner le bouton.
Dans la fenêtre Propriétés, définissez les propriétés suivantes du bouton :
- Définissez la propriété Text sur Say Hello.
- Définissez la propriété (Name) sur btnProtected.
- Définissez la propriété Modificateurs sur Protected. Cela permet aux formulaires qui héritent de Form1 de modifier les propriétés de btnProtected.
Double-cliquez sur le bouton Say Hello pour ajouter un gestionnaire d’événements pour l’événement Click .

Ajoutez la ligne de code suivante au gestionnaire d'événements :

MessageBox.Show("Hello, World!")

MessageBox.Show("Hello, World!");

Ajouter un bouton qui ne peut pas être modifié par les héritiers du formulaire de base

Basculez vers le mode Création en cliquant sur l’onglet Form1.vb [Design], Form1.cs [Design], ou Form1.jsl [Design] au-dessus de l’éditeur de code, ou en appuyant sur F7.
Ajoutez un deuxième bouton et définissez ses propriétés comme suit :
- Définissez la propriété Text sur Say Goodbye.
- Définissez la propriété (Name) sur btnPrivate.
- Définissez la propriété Modificateurs sur Private. Cela rend impossible pour les formulaires qui héritent de Form1 de modifier les propriétés de btnPrivate.
Double-cliquez sur le bouton Say Goodbye pour ajouter un gestionnaire d’événements pour l’événement Click . Placez la ligne de code suivante dans la procédure d'événement :
```
MessageBox.Show("Goodbye!")
```
```
MessageBox.Show("Goodbye!");
```
Dans le menu Build , choisissez Build BaseForm Library pour générer la bibliothèque de classes.

Une fois la bibliothèque générée, vous pouvez créer un projet qui hérite du formulaire que vous venez de créer.

Créer un projet contenant un formulaire qui hérite du formulaire de base

Dans le menu Fichier , choisissez Ajouter , puis Nouveau projet pour ouvrir la boîte de dialogue Ajouter un nouveau projet .
Créez une application Windows Forms nommée InheritanceTest.

Ajouter un formulaire hérité

Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet InheritanceTest, sélectionnez Ajouter, puis sélectionnez Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez la catégorie Windows Forms (si vous avez une liste de catégories), puis sélectionnez le modèle de formulaire hérité.
Laissez le nom par défaut, Form2 puis cliquez sur Ajouter.
Dans la boîte de dialogue Sélecteur d’héritage, sélectionnez Form1 dans le projet BaseFormLibrary comme formulaire à hériter, puis cliquez sur OK.

Cela crée un formulaire dans le projet InheritanceTest qui dérive du formulaire dans BaseFormLibrary.
Ouvrez le formulaire hérité (Form2) dans le concepteur en double-cliquant dessus, s’il n’est pas déjà ouvert.

Dans le concepteur, les boutons hérités ont un symbole () dans leur coin supérieur, indiquant qu’ils sont hérités.
Sélectionnez le bouton Say Hello et observez les poignées de redimensionnement. Ce bouton étant protégé, les héritiers peuvent le déplacer, le redimensionner, changer sa légende et apporter d'autres modifications.
Sélectionnez le bouton Say Goodbye privé et notez qu’il n’a pas de poignées de redimensionnement. En outre, dans la fenêtre Propriétés , les propriétés de ce bouton sont grisées pour indiquer qu’elles ne peuvent pas être modifiées.
Si vous utilisez Visual C# :
1. Dans Explorateur de solutions, cliquez avec le bouton droit sur Form1 dans le projet InheritanceTest, puis choisissez Supprimer. Dans la zone de message qui s’affiche, cliquez sur OK pour confirmer la suppression.
2. Ouvrez le fichier Program.cs et remplacez la ligne Application.Run(new Form1()); par Application.Run(new Form2());.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet InheritanceTest, puis sélectionnez Définir comme projet de démarrage.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet InheritanceTest, puis sélectionnez Propriétés.
Dans les pages de propriétés InheritanceTest, définissez l’objetStartup comme étant le formulaire hérité (Form2).
Appuyez sur F5 pour exécuter l’application et observez le comportement du formulaire hérité.

Étapes suivantes

L'héritage pour les contrôles utilisateur fonctionne de la même façon. Ouvrez un nouveau projet de bibliothèque de classes et ajoutez un contrôle utilisateur. Placez les contrôles constituants dessus et compilez le projet. Ouvrez un autre projet de bibliothèque de classes et ajoutez une référence à la bibliothèque de classes compilée. Essayez également d’ajouter un contrôle hérité (via la boîte de dialogue Ajouter de nouveaux éléments ) au projet et à l’aide du sélecteur d’héritage. Ajoutez un contrôle utilisateur et modifiez l’instruction Inherits (: en Visual C#). Pour plus d’informations, consultez Guide pratique pour hériter de Windows Forms.

Partager via