Événements de contrôle (Windows Forms .NET)

Article
10/18/2023

Les contrôles fournissent des événements déclenchés lorsque l’utilisateur interagit avec le contrôle ou lorsque l’état du contrôle change. Cet article décrit les événements courants partagés par la plupart des contrôles, des événements déclenchés par l’interaction utilisateur et des événements propres à des contrôles spécifiques. Pour plus d’informations sur les événements dans Windows Forms, consultez vue d’ensemble des événements et gestion et déclenchement d’événements.

Pour plus d’informations sur l’ajout ou la suppression d’un gestionnaire d’événements de contrôle, consultez Comment gérer un événement.

Événements courants

Les contrôles fournissent plus de 60 événements via la classe Controlde base. Il s’agit notamment de l’événementPaint, qui entraîne le dessin d’un contrôle, des événements liés à l’affichage d’une fenêtre, tels que les événements et Layout les Resize événements de souris et de clavier de bas niveau. Certains événements de bas niveau sont synthétisés en Control événements sémantiques tels que Click et DoubleClick. La plupart des événements partagés se trouvent sous ces catégories :

Événements de souris
Événements de clavier
Événements modifiés de propriété
Autres événements

Événements de souris

Étant donné que Windows Forms est une technologie d’interface utilisateur, l’entrée de la souris est la principale façon dont les utilisateurs interagissent avec une application Windows Forms. Tous les contrôles fournissent des événements liés à la souris de base :

Pour plus d’informations, consultez Utilisation des événements de souris.

Événements de clavier

Si le contrôle répond à l’entrée utilisateur, telle qu’un ou Button un TextBox contrôle, l’événement d’entrée approprié est déclenché pour le contrôle. Le contrôle doit être concentré pour recevoir des événements de clavier. Certains contrôles, tels que le Label contrôle, ne peuvent pas être concentrés et ne peuvent pas recevoir d’événements de clavier. Voici une liste d’événements de clavier :

Pour plus d’informations, consultez Utilisation des événements de clavier.

Événements modifiés de propriété

Windows Forms suit le modèle PropertyNameChanged pour les propriétés qui ont des événements de modification. Le moteur de liaison de données fourni par Windows Forms reconnaît ce modèle et s’intègre bien à celui-ci. Lorsque vous créez vos propres contrôles, implémentez ce modèle.

Ce modèle implémente les règles suivantes, à l’aide de la propriété FirstName comme exemple :

Nommez votre propriété : FirstName.
Créez un événement pour la propriété à l’aide du modèle PropertyNameChanged: FirstNameChanged.
Créez une méthode privée ou protégée à l’aide du modèle OnPropertyNameChanged: OnFirstNameChanged.

Si le jeu de FirstName propriétés modifie la valeur de stockage, la OnFirstNameChanged méthode est appelée. La méthode OnFirstNameChanged déclenche l'événement FirstNameChanged.

Voici quelques-uns des événements courants de modification de propriété pour un contrôle :

Événement	Description
BackColorChanged	Se produit quand la valeur de la propriété BackColor change.
BackgroundImageChanged	Se produit quand la valeur de la propriété BackgroundImage change.
BindingContextChanged	Se produit quand la valeur de la propriété BindingContext change.
DockChanged	Se produit quand la valeur de la propriété Dock change.
EnabledChanged	Se produit quand la valeur de propriété Enabled a été modifiée.
FontChanged	Se produit lorsque la valeur de la propriété Font est modifiée.
ForeColorChanged	Se produit lorsque la valeur de la propriété ForeColor est modifiée.
LocationChanged	Se produit quand la valeur de propriété Location a été modifiée.
SizeChanged	Se produit lorsque la valeur de la propriété Size est modifiée.
VisibleChanged	Se produit lorsque la valeur de la propriété Visible est modifiée.

Pour obtenir la liste complète des événements, consultez la section Événements de la classe de contrôle.

Autres événements

Les contrôles déclenchent également des événements en fonction de l’état du contrôle ou d’autres interactions avec le contrôle. Par exemple, l’événement HelpRequested est déclenché si le contrôle a le focus et que l’utilisateur appuie sur la touche F1 . Cet événement est également déclenché si l’utilisateur appuie sur le bouton d’aide contextuel sur un formulaire, puis appuie sur le curseur d’aide sur le contrôle.

Un autre exemple consiste à modifier, déplacer ou redimensionner un contrôle. L’événement Paint est déclenché. Cet événement permet au développeur de tirer parti du contrôle et de modifier son apparence.