Control.OnBackgroundImageChanged(EventArgs) Méthode

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 propriété Text change.The following code example is an event-raising method that is executed when the Text property value changes. La classe Control a plusieurs méthodes avec le modèle de nom OnPropertyNameChanged qui déclenchent l’événement PropertyNameChanged correspondant 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 OnPropertyNameChanged 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 la ForeColor d’une classe dérivée TextBox affichant des 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 classe TextBox.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.

S’applique à

Voir aussi

• BackgroundImageChanged
• BackgroundImage