Control.OnBackColorChanged(EventArgs) Control.OnBackColorChanged(EventArgs) Control.OnBackColorChanged(EventArgs) Control.OnBackColorChanged(EventArgs) Method

Définition

Déclenche l'événement BackColorChanged.Raises the BackColorChanged event.

protected:
 virtual void OnBackColorChanged(EventArgs ^ e);
protected virtual void OnBackColorChanged (EventArgs e);
abstract member OnBackColorChanged : EventArgs -> unit
override this.OnBackColorChanged : EventArgs -> unit
Protected Overridable Sub OnBackColorChanged (e As EventArgs)

Paramètres

e
EventArgs EventArgs EventArgs EventArgs

EventArgs qui contient les données d'événement.An EventArgs that contains the event data.

Exemples

L’exemple de code suivant est une méthode de déclenchement d’événements qui est exécutée lorsque la Text valeur de propriété change.The following code example is an event-raising method that is executed when the Text property value changes. Le Control classe possède plusieurs méthodes avec le modèle de nom On PropertyName Changed qui déclenchent le correspondantes PropertyName Changed événement lors de la PropertyName valeur modifiée (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).

Le code suivant exemple modifie le ForeColor d’un TextBox affichage des données de devise de classe dérivée.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 modifications le ForeColor à 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 disposez 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 OnBackColorChanged permet également aux classes dérivées de gérer l'événement sans y attacher de délégué.The OnBackColorChanged 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 OnBackColorChanged(EventArgs) dans une classe dérivée, veillez à appeler la méthode OnBackColorChanged(EventArgs) de la classe de base de manière à ce que les délégués inscrits reçoivent l'événement.When overriding OnBackColorChanged(EventArgs) in a derived class, be sure to call the base class's OnBackColorChanged(EventArgs) method so that registered delegates receive the event.

S’applique à

Voir aussi