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

Definition

Löst das BackColorChanged-Ereignis aus.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)

Parameter

e
EventArgs EventArgs EventArgs EventArgs

Ein EventArgs, das die Ereignisdaten enthält.An EventArgs that contains the event data.

Beispiele

Das folgende Codebeispiel ist eine Ereignis erbende Methode, die ausgeführt wird, Text wenn sich der-Eigenschafts Wert ändert.The following code example is an event-raising method that is executed when the Text property value changes. Die Control -Klasse verfügt über mehrere Methoden mit dem OnNamensmuster propertyName Changed , das das entsprechende propertyName Changed -Ereignis aufhebt, wenn der propertyName -Wert geändert wird. PropertyName stellt den Namen der entsprechenden Eigenschaft dar.)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).

Im folgenden Codebeispiel wird der ForeColor einer TextBox abgeleiteten Klasse, die Währungs Daten anzeigt, geändert.The following code example changes the ForeColor of a TextBox derived class displaying currency data. Im Beispiel wird der Text in eine Dezimalzahl konvertiert und der ForeColor in Color.Red geändert, wenn die Zahl negativ ist Color.Black , und, wenn die Zahl positiv ist.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. Dieses Beispiel erfordert, dass Sie über eine-Klasse verfügen, TextBox die von der-Klasse abgeleitet ist.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

Hinweise

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen.Raising an event invokes the event handler through a delegate. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.For more information, see Handling and Raising Events.

Mit der OnBackColorChanged-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln.The OnBackColorChanged method also allows derived classes to handle the event without attaching a delegate. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.This is the preferred technique for handling the event in a derived class.

Hinweise für Vererber

Wenn Sie OnBackColorChanged(EventArgs) in einer abgeleiteten Klasse überschreiben, müssen Sie die OnBackColorChanged(EventArgs)-Methode der Basisklasse aufrufen, damit registrierte Delegaten das Ereignis empfangen.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.

Gilt für:

Siehe auch