Control.OnDockChanged(EventArgs) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Déclenche l’événement DockChanged.

protected:
 virtual void OnDockChanged(EventArgs ^ e);

protected virtual void OnDockChanged (EventArgs e);

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

Protected Overridable Sub OnDockChanged (e As EventArgs)

Paramètres

e

EventArgs

EventArgs qui contient les données d’événement.

Exemples

L’exemple de code suivant est une méthode de levée d’événements qui est exécutée lorsque la valeur de la Text propriété change. La Control classe a plusieurs méthodes avec le modèle Onde nom PropertyNameChanged qui déclenchent l’événement PropertyNameChanged correspondant lorsque la valeur PropertyName change (PropertyName représente le nom de la propriété correspondante).

L’exemple de code suivant modifie le ForeColor d’une TextBox classe dérivée affichant des données monétaires. L’exemple convertit le texte en nombre décimal et change le ForeColor en Color.Red si le nombre est négatif et en Color.Black si le nombre est positif. Cet exemple nécessite que vous ayez une classe qui dérive de la TextBox classe .

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é. Pour plus d’informations, consultez gestion et déclenchement d’événements.

La méthode OnDockChanged permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

Lors de la substitution de OnDockChanged(EventArgs) dans une classe dérivée, veillez à appeler la méthode OnDockChanged(EventArgs) de la classe de base de manière à ce que les délégués inscrits reçoivent l'événement.

Voir aussi

• DockChanged
• Dock