Ler em inglês

Compartilhar via


Control.OnParentBackgroundImageChanged(EventArgs) Método

Definição

Gera o evento BackgroundImageChanged quando o valor da propriedade BackgroundImage de alterações do contêiner do controle muda.

C#
protected virtual void OnParentBackgroundImageChanged(EventArgs e);

Parâmetros

e
EventArgs

Um EventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir é um método de geração de eventos executado quando o valor da Text propriedade é alterado. A Control classe tem vários métodos com o padrão Onde nome PropertyNameChanged que geram o evento PropertyNameChanged correspondente quando o valor PropertyName é alterado (PropertyName representa o nome da propriedade correspondente).

O exemplo de código a seguir altera o ForeColor de uma TextBox classe derivada exibindo dados de moeda. O exemplo converte o texto em um número decimal e altera o ForeColor para Color.Red se o número for negativo e para Color.Black se o número for positivo. Este exemplo exige que você tenha uma classe derivada da TextBox classe .

C#
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);
}

Comentários

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.

O OnParentBackgroundImageChanged método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnParentBackgroundImageChanged(EventArgs) em uma classe derivada, chame o método da OnParentBackgroundImageChanged(EventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Confira também