Partager via

Événements de contrôle

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 offrent plus de 60 événements grâce à la classe de base Control. Il s’agit notamment de l’événement Paint, ce 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 Resize et Layout, ainsi que les événements de souris et de clavier de bas niveau. Certains événements de bas niveau sont synthétisés par Control en é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 de changement 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 Utiliser des événements de souris.

Événements de clavier

Si le contrôle répond à l’entrée utilisateur, telle qu’un contrôle TextBox ou Button, l’événement d’entrée approprié est déclenché pour le contrôle. Le contrôle doit être prioritaire pour recevoir des événements de clavier. Certains contrôles, tels que le contrôle Label, 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 Utiliser des événements de clavier.

Événements de changement 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 propriétés FirstName modifie la valeur de sauvegarde, la méthode OnFirstNameChanged 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 Descriptif
BackColorChanged Se produit lorsque la valeur de la propriété BackColor change.
BackgroundImageChanged Se produit lorsque la valeur de la propriété BackgroundImage change.
BindingContextChanged Se produit lorsque la valeur de la propriété BindingContext change.
DockChanged Se produit lorsque la valeur de la propriété Dock change.
EnabledChanged Se produit lorsque la valeur de la propriété Enabled aura changé.
FontChanged Se produit lorsque la valeur de propriété Font change.
ForeColorChanged Se produit lorsque la valeur de propriété ForeColor change.
LocationChanged Se produit lorsque la valeur de la propriété Location aura changé.
SizeChanged Se produit lorsque la valeur de propriété Size change.
VisibleChanged Se produit lorsque la valeur de propriété Visible change.

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 sur le curseur d'aide sur le contrôle.

Un autre exemple est le moment où un contrôle est modifié, déplacé ou redimensionné, 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.

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

Voir aussi

  • Last updated on