Teilen über


Control.Leave Ereignis

Definition

Tritt ein, wenn der Eingabefokus das Steuerelement verlässt.

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

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird das Leave -Ereignis verwendet, um ein Steuerelement auf den früheren Zustand zurückzusetzen.

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

Hinweise

Wenn Sie den Fokus mithilfe der Tastatur (TAB, UMSCHALT+TAB usw.) ändern, indem Sie die Select -Methode oder SelectNextControl aufrufen oder die ContainerControl.ActiveControl -Eigenschaft auf das aktuelle Formular festlegen, treten Fokusereignisse in der folgenden Reihenfolge auf:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Wenn Sie den Fokus mithilfe der Maus oder durch Aufrufen der Focus -Methode ändern, treten Fokusereignisse in der folgenden Reihenfolge auf:

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

Wenn die CausesValidation -Eigenschaft auf falsefestgelegt ist, werden die Validating Ereignisse und Validated unterdrückt.

Hinweis

Die Enter Ereignisse und Leave werden von der Form -Klasse unterdrückt. Die entsprechenden Ereignisse in der Form -Klasse sind die Activated - und Deactivate -Ereignisse. Die Enter Ereignisse und Leave sind hierarchisch und kaskadieren die übergeordnete Kette nach oben und unten, bis das entsprechende Steuerelement erreicht ist. Angenommen, Sie verfügen über ein Form mit zwei GroupBox Steuerelementen, und jedes GroupBox Steuerelement verfügt über ein TextBox Steuerelement. Wenn der Caret von einem TextBox in den anderen verschoben wird, wird das Leave Ereignis für und TextBoxGroupBoxausgelöst, und das Enter Ereignis wird für das andere GroupBox und TextBoxausgelöst.

Achtung

Versuchen Sie nicht, den Fokus innerhalb der EnterEreignishandler , GotFocus, Leave, ValidatingLostFocusoder Validated festzulegen. Dies kann dazu führen, dass Ihre Anwendung oder das Betriebssystem nicht mehr reagiert. Weitere Informationen finden Sie im Thema WM_KILLFOCUS .

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen