Control.OnBackColorChanged(EventArgs) Metodo

Definizione

Genera l'evento 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)

Parametri

e
EventArgs

Oggetto EventArgs che contiene i dati dell'evento.An EventArgs that contains the event data.

Esempi

L'esempio di codice seguente è un metodo di generazione di eventi che viene eseguito quando viene modificato il valore della proprietà Text.The following code example is an event-raising method that is executed when the Text property value changes. La classe Control ha diversi metodi con il modello di nome OnPropertyNameChanged che generano l'evento PropertyNameChanged corrispondente quando viene modificato il valore PropertyName (PropertyName rappresenta il nome della proprietà corrispondente.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).

Nell'esempio di codice seguente viene modificato il ForeColor di una classe derivata TextBox che Visualizza i dati di valuta.The following code example changes the ForeColor of a TextBox derived class displaying currency data. Nell'esempio il testo viene convertito in un numero decimale e il ForeColor viene modificato in Color.Red se il numero è negativo e Color.Black Se il numero è positivo.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. Per questo esempio è necessario disporre di una classe che derivi dalla 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

Commenti

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato.Raising an event invokes the event handler through a delegate. Per altre informazioni, vedere la gestione e generazione di eventi.For more information, see Handling and Raising Events.

Il metodo OnBackColorChanged consente inoltre alle classi derivate di gestire l'evento senza associare un delegato.The OnBackColorChanged method also allows derived classes to handle the event without attaching a delegate. È la tecnica consigliata per la gestione dell'evento in una classe derivata.This is the preferred technique for handling the event in a derived class.

Note per gli eredi

Quando si esegue l'override di OnBackColorChanged(EventArgs) in una classe derivata, verificare di chiamare il metodo OnBackColorChanged(EventArgs) della classe di base in modo che i delegati registrati ricevano l'evento.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.

Si applica a

Vedi anche