Control.Enter Ereignis

Definition

Tritt beim Eintreten in den Bereich des Steuerelements ein.Occurs when the control is entered.

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

Beispiele

Im folgenden Codebeispiel wird das Enter-Ereignis verwendet, um die Vordergrund-und Hintergrundfarben einer TextBox unter bestimmten Bedingungen zu ändern.The following code example uses the Enter event to change the foreground and background colors of a TextBox under particular conditions.

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 Methoden Select oder SelectNextControl aufrufen, oder indem Sie die Eigenschaft ContainerControl.ActiveControl auf das aktuelle Formular festlegen, treten Fokus Ereignisse in der folgenden Reihenfolge auf:When you change the focus by using the keyboard (TAB, SHIFT+TAB, and so on), by calling the Select or SelectNextControl methods, or by setting the ContainerControl.ActiveControl property to the current form, focus events occur in the following order:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Wenn Sie den Fokus mit der Maus oder durch Aufrufen der Focus-Methode ändern, treten Fokus Ereignisse in der folgenden Reihenfolge auf:When you change the focus by using the mouse or by calling the Focus method, focus events occur in the following order:

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

Wenn die CausesValidation-Eigenschaft auf false festgelegt ist, werden die Ereignisse Validating und Validated unterdrückt.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Hinweis

Die Ereignisse Enter und Leave werden von der Form-Klasse unterdrückt.The Enter and Leave events are suppressed by the Form class. Die äquivalenten Ereignisse in der Form-Klasse sind die Ereignisse Activated und Deactivate.The equivalent events in the Form class are the Activated and Deactivate events. Die Ereignisse Enter und Leave sind hierarchisch und werden in der übergeordneten Kette nach oben und unten verschoben, bis das entsprechende Steuerelement erreicht wird.The Enter and Leave events are hierarchical and will cascade up and down the parent chain until the appropriate control is reached. Angenommen, Sie verfügen über eine Form mit zwei GroupBox-Steuerelementen, und jedes GroupBox-Steuerelement verfügt über ein TextBox-Steuerelement.For example, assume you have a Form with two GroupBox controls, and each GroupBox control has one TextBox control. Wenn die Einfügemarke von einem TextBox zum anderen verschoben wird, wird das Leave-Ereignis für die TextBox und GroupBox ausgelöst, und das Enter-Ereignis wird für die anderen GroupBox und TextBox ausgelöst.When the caret is moved from one TextBox to the other, the Leave event is raised for the TextBox and GroupBox, and the Enter event is raised for the other GroupBox and TextBox.

Achtung

Versuchen Sie nicht, den Fokus innerhalb der Ereignishandler "Enter", "GotFocus", "Leave", "LostFocus", "Validating" oder "Validated" festzulegen.Do not attempt to set focus from within the Enter, GotFocus, Leave, LostFocus, Validating, or Validated event handlers. Dies kann dazu führen, dass Ihre Anwendung oder das Betriebssystem nicht mehr reagiert.Doing so can cause your application or the operating system to stop responding. Weitere Informationen finden Sie im Thema "WM_KILLFOCUS" im Abschnitt "Tastatureingabe Referenz" und im Abschnitt "Nachrichten Deadlocks" des Themas about Messages and Message Queues .For more information, see the WM_KILLFOCUS topic in the "Keyboard Input Reference" section and the "Message Deadlocks" section of the About Messages and Message Queues topic.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Gilt für:

Siehe auch