Control.OnBackgroundImageChanged(EventArgs) Méthode
Définition
Déclenche l’événement BackgroundImageChanged.Raises the BackgroundImageChanged event.
protected:
virtual void OnBackgroundImageChanged(EventArgs ^ e);
protected virtual void OnBackgroundImageChanged (EventArgs e);
abstract member OnBackgroundImageChanged : EventArgs -> unit
override this.OnBackgroundImageChanged : EventArgs -> unit
Protected Overridable Sub OnBackgroundImageChanged (e As EventArgs)
Paramètres
Exemples
L’exemple de code suivant est une méthode de déclenchement d’événements qui est exécutée lorsque la valeur de la Text propriété change.The following code example is an event-raising method that is executed when the Text property value changes. La Control classe a plusieurs méthodes avec le modèle de nom On
PropertyName Changed
qui déclenchent l’événement PropertyName correspondant Changed
lorsque la valeur PropertyName change (PropertyName représente le nom de la propriété correspondante).The Control class has several methods with the name pattern On
PropertyNameChanged
that raise the corresponding PropertyNameChanged
event when the PropertyName value changes (PropertyName represents the name of the corresponding property).
L’exemple de code suivant modifie le ForeColor d’une TextBox classe dérivée qui affiche les données monétaires.The following code example changes the ForeColor of a TextBox derived class displaying currency data. L’exemple convertit le texte en nombre décimal et modifie le ForeColor en Color.Red si le nombre est négatif et Color.Black si le nombre est positif.The example converts the text to a decimal number and changes the ForeColor to Color.Red if the number is negative and to Color.Black if the number is positive. Cet exemple nécessite que vous disposiez d’une classe qui dérive de la TextBox classe.This example requires that you have a class that derives from the TextBox class.
protected:
virtual void OnTextChanged( System::EventArgs^ e ) override
{
try
{
// Convert the text to a Double and determine
// if it is a negative number.
if ( Double::Parse( this->Text ) < 0 )
{
// If the number is negative, display it in Red.
this->ForeColor = Color::Red;
}
else
{
// If the number is not negative, display it in Black.
this->ForeColor = Color::Black;
}
}
catch ( Exception^ )
{
// If there is an error, display the
// text using the system colors.
this->ForeColor = SystemColors::ControlText;
}
TextBox::OnTextChanged( e );
}
protected override void OnTextChanged(System.EventArgs e)
{
try
{
// Convert the text to a Double and determine
// if it is a negative number.
if(double.Parse(this.Text) < 0)
{
// If the number is negative, display it in Red.
this.ForeColor = Color.Red;
}
else
{
// If the number is not negative, display it in Black.
this.ForeColor = Color.Black;
}
}
catch
{
// If there is an error, display the
// text using the system colors.
this.ForeColor = SystemColors.ControlText;
}
base.OnTextChanged(e);
}
Protected Overrides Sub OnTextChanged(e As System.EventArgs)
Try
' Convert the text to a Double and determine
' if it is a negative number.
If Double.Parse(Me.Text) < 0 Then
' If the number is negative, display it in Red.
Me.ForeColor = Color.Red
Else
' If the number is not negative, display it in Black.
Me.ForeColor = Color.Black
End If
Catch
' If there is an error, display the
' text using the system colors.
Me.ForeColor = SystemColors.ControlText
End Try
MyBase.OnTextChanged(e)
End Sub
Remarques
Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué.Raising an event invokes the event handler through a delegate. Pour plus d’informations, consultez gestion et déclenchement d’événements.For more information, see Handling and Raising Events.
La méthode OnBackgroundImageChanged permet également aux classes dérivées de gérer l'événement sans y attacher de délégué.The OnBackgroundImageChanged method also allows derived classes to handle the event without attaching a delegate. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.This is the preferred technique for handling the event in a derived class.
Notes pour les héritiers
Lors de la substitution de OnBackgroundImageChanged(EventArgs) dans une classe dérivée, veillez à appeler la méthode OnBackgroundImageChanged(EventArgs) de la classe de base de manière à ce que les délégués inscrits reçoivent l'événement.When overriding OnBackgroundImageChanged(EventArgs) in a derived class, be sure to call the base class's OnBackgroundImageChanged(EventArgs) method so that registered delegates receive the event.