Control.Enter Control.Enter Control.Enter Control.Enter Event

Определение

Происходит при входе в элемент управления.Occurs when the control is entered.

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

Примеры

В следующем примере кода используется Enter событие, чтобы изменить цвета переднего плана и фона TextBox под определенным условиям.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 'textBox1_Enter
   
   
    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 'textBox1_Leave
End Class 'Form1 

Комментарии

При изменении фокуса с помощью клавиатуры (TAB, SHIFT + TAB и т. д.), путем вызова Select или SelectNextControl методов, или установив ContainerControl.ActiveControl свойство с текущей формой, события фокуса происходят в следующем порядке: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

При изменении фокуса с помощью мыши или путем вызова Focus метод, события фокуса происходят в следующем порядке: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

Если CausesValidation свойству false, Validating и Validated события подавляются.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Примечание

Enter И Leave события подавляются модулем Form класса.The Enter and Leave events are suppressed by the Form class. Эквивалентные события в Form класса Activated и Deactivate события.The equivalent events in the Form class are the Activated and Deactivate events. Enter И Leave события являются иерархическими и будут передаваться в родительской цепочке пока не будет достигнут соответствующий элемент управления.The Enter and Leave events are hierarchical and will cascade up and down the parent chain until the appropriate control is reached. Например, предположим, у вас есть Form с двумя GroupBox элементов управления, при этом каждая GroupBox элемент управления имеет один TextBox элемента управления.For example, assume you have a Form with two GroupBox controls, and each GroupBox control has one TextBox control. При перемещении курсора из одно TextBox , Leave события для TextBox и GroupBoxи Enter события для других GroupBox и TextBox.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.

Внимание!

Не пытайтесь задать фокус из Enter, GotFocus, Leave, LostFocus, Validating, или Validated обработчики событий.Do not attempt to set focus from within the Enter, GotFocus, Leave, LostFocus, Validating, or Validated event handlers. Это может вызвать приложение или операционная система перестает отвечать на запросы.Doing so can cause your application or the operating system to stop responding. Дополнительные сведения см. в разделе WM_KILLFOCUS раздел в разделе «Справочник по входным клавиатуры» и разделе «Сообщения взаимоблокировок» о сообщения и очереди сообщений раздела.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.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

Применяется к

Дополнительно