Control.OnLocationChanged(EventArgs) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Gera o evento LocationChanged.

protected:
 virtual void OnLocationChanged(EventArgs ^ e);

protected virtual void OnLocationChanged (EventArgs e);

abstract member OnLocationChanged : EventArgs -> unit
override this.OnLocationChanged : EventArgs -> unit

Protected Overridable Sub OnLocationChanged (e As EventArgs)

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 que é executado quando o valor da propriedade Text é alterado. A classe tem vários métodos com o padrão de nome PropertyName que geram o evento PropertyName correspondente quando o PropertyName valor é alterado (PropertyName representa o nome da propriedade correspondente).

O exemplo de código a seguir altera o ForeColor de uma classe derivada TextBox 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 Color.Black se o número for positivo. Este exemplo exige que você tenha uma classe derivada da classe TextBox.

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

Comentários

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

O método OnLocationChanged 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 OnLocationChanged(EventArgs) em uma classe derivada, chame o método OnLocationChanged(EventArgs) da classe base para que os delegados registrados recebam o evento.

Aplica-se a

Partilhar via