Control.Enter Événement

Définition

Se produit lorsque l'utilisateur entre dans le contrôle.

public:
 event EventHandler ^ Enter;
public event EventHandler Enter;
public event EventHandler? Enter;
member this.Enter : EventHandler 
Public Custom Event Enter As EventHandler 

Type d'événement

Exemples

L’exemple de code suivant utilise l’événement Enter pour modifier les couleurs de premier plan et d’arrière-plan d’un dans des TextBox conditions particulières.

private:
   void textBox1_Enter( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // If the TextBox contains text, change its foreground and background colors.
      if ( textBox1->Text != String::Empty )
      {
         textBox1->ForeColor = Color::Red;
         textBox1->BackColor = Color::Black;

         // Move the selection pointer to the end of the text of the control.
         textBox1->Select(textBox1->Text->Length,0);
      }
   }

   void textBox1_Leave( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Reset the colors and selection of the TextBox after focus is lost.
      textBox1->ForeColor = Color::Black;
      textBox1->BackColor = Color::White;
      textBox1->Select(0,0);
   }
private void textBox1_Enter(object sender, System.EventArgs e)
{
    // If the TextBox contains text, change its foreground and background colors.
    if (!string.IsNullOrEmpty(textBox1.Text))
    {
        textBox1.ForeColor = Color.Red;
        textBox1.BackColor = Color.Black;
        // Move the selection pointer to the end of the text of the control.
        textBox1.Select(textBox1.Text.Length, 0);
    }
}

private void textBox1_Leave(object sender, System.EventArgs e)
{
    // Reset the colors and selection of the TextBox after focus is lost.
    textBox1.ForeColor = Color.Black;
    textBox1.BackColor = Color.White;
    textBox1.Select(0,0);
}
    Private Sub textBox1_Enter(sender As Object, e As System.EventArgs) Handles textBox1.Enter
        ' If the TextBox contains text, change its foreground and background colors.
        If textBox1.Text <> [String].Empty Then
            textBox1.ForeColor = Color.Red
            textBox1.BackColor = Color.Black
            ' Move the selection pointer to the end of the text of the control.
            textBox1.Select(textBox1.Text.Length, 0)
        End If
    End Sub
   
   
    Private Sub textBox1_Leave(sender As Object, e As System.EventArgs) Handles textBox1.Leave
        ' Reset the colors and selection of the TextBox after focus is lost.
        textBox1.ForeColor = Color.Black
        textBox1.BackColor = Color.White
        textBox1.Select(0, 0)
    End Sub
End Class

Remarques

Lorsque vous modifiez le focus à l’aide du clavier (TAB, MAJ+TAB, et ainsi de suite), en appelant les Select méthodes ou SelectNextControl ou en définissant la ContainerControl.ActiveControl propriété sur le formulaire actuel, les événements de focus se produisent dans l’ordre suivant :

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Lorsque vous modifiez le focus à l’aide de la souris ou en appelant la Focus méthode , les événements de focus se produisent dans l’ordre suivant :

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

Si la CausesValidation propriété est définie sur false, les Validating événements et Validated sont supprimés.

Notes

Les Enter événements et Leave sont supprimés par la Form classe . Les événements équivalents dans la Form classe sont les Activated événements et Deactivate . Les Enter événements et Leave sont hiérarchiques et s’exécutent en cascade dans la chaîne parente jusqu’à ce que le contrôle approprié soit atteint. Par exemple, supposons que vous avez un Form avec deux GroupBox contrôles et que chaque GroupBox contrôle a un TextBox contrôle. Lorsque l’insertion est déplacée de l’un TextBox vers l’autre, l’événement Leave est déclenché pour et TextBoxGroupBox, et l’événement Enter est déclenché pour l’autre GroupBox et TextBox.

Attention

N’essayez pas de définir le Enterfocus à partir des gestionnaires d’événements , GotFocusLeave, LostFocus, Validating, ou Validated . Cela peut entraîner l’arrêt de la réponse de votre application ou du système d’exploitation. Pour plus d’informations, consultez la WM_KILLFOCUS rubrique de la section « Référence d’entrée au clavier » et la section « Interblocages de messages » de la rubrique À propos des messages et des files d’attente de messages .

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Voir aussi