ControlEventHandler Délégué

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ControlEventHandler.cs

Représente la méthode qui gérera les événements ControlAdded et ControlRemoved de la classe Control.

C#

public delegate void ControlEventHandler(object? sender, ControlEventArgs e);

Paramètres

sender

Object

Source de l'événement.

e

ControlEventArgs

ControlEventArgs qui contient les données d’événement.

Exemples

L’exemple de code suivant crée un Binding, ajoute un ConvertEventHandler délégué à la fois aux Parse événements et Format , et ajoute le Binding au BindingsCollection d’un TextBox contrôle via la DataBindings propriété . Le DecimalToCurrencyString délégué d’événement, ajouté à l’événement Format , met en forme la valeur liée (un Decimal type) en tant que devise à l’aide de la ToString méthode . Le CurrencyStringToDecimal délégué d’événement, ajouté à l’événement Parse , reconvertit la valeur affichée par le contrôle en Decimal type.

C#

private void BindControl()
{
   // Create the binding first. The OrderAmount is typed as Decimal.
   Binding b = new Binding
      ("Text", ds, "customers.custToOrders.OrderAmount");
   // Add the delegates to the events.
   b.Format += new ConvertEventHandler(DecimalToCurrencyString);
   b.Parse += new ConvertEventHandler(CurrencyStringToDecimal);
   text1.DataBindings.Add(b);
}

private void DecimalToCurrencyString(object sender, ConvertEventArgs cevent)
{
   // Check for the appropriate DesiredType.
   if(cevent.DesiredType != typeof(string)) return;

   // Use the ToString method to format the value as currency ("c").
   cevent.Value = ((decimal) cevent.Value).ToString("c");
}

private void CurrencyStringToDecimal(object sender, ConvertEventArgs cevent)
{
   // Check for the appropriate DesiredType. 
   if(cevent.DesiredType != typeof(decimal)) return;

   // Convert the string back to decimal using the static Parse method.
   cevent.Value = Decimal.Parse(cevent.Value.ToString(),
   NumberStyles.Currency, null);
}

Remarques

Lorsque vous créez un délégué ControlEventArgs, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaires d’événements, consultez Gestion et déclenchement d’événements.

Méthodes d’extension

S’applique à

Voir aussi

• Binding
• ControlEventArgs
• ControlAdded
• ControlRemoved