Control.GotFocus Control.GotFocus Control.GotFocus Control.GotFocus Event

Определение

Вызывается при получении фокуса элементом управления.Occurs when the control receives focus.

public:
 event EventHandler ^ GotFocus;
[System.ComponentModel.Browsable(false)]
public event EventHandler GotFocus;
member this.GotFocus : EventHandler 
Public Custom Event GotFocus As EventHandler 
Атрибуты

Примеры

В следующем примере кода показано использование этого элемента.The following code example demonstrates the use of this member. В примере обработчик событий сообщает о вхождение GotFocus событий.In the example, an event handler reports on the occurrence of the GotFocus event. Этот отчет позволяет выяснить, когда происходит событие и может оказаться полезным при отладке.This report helps you to learn when the event occurs and can assist you in debugging.

Чтобы запустить пример кода, вставьте его в проект, который содержит экземпляр типа, который наследует от Control, такие как Button или ComboBox.To run the example code, paste it into a project that contains an instance of a type that inherits from Control, such as a Button or ComboBox. Введите имя экземпляра Control1 и убедитесь, что обработчик событий, связанный с GotFocus событий.Then name the instance Control1 and ensure that the event handler is associated with the GotFocus event.

private void Control1_GotFocus(Object sender, EventArgs e) {

   MessageBox.Show("You are in the Control.GotFocus event.");

}
Private Sub Control1_GotFocus(sender as Object, e as EventArgs) _ 
     Handles Control1.GotFocus

Console.WriteLine("You are in the Control.GotFocus event.")

End Sub

Комментарии

При изменении фокуса с помощью клавиатуры (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.

Примечание GotFocus и LostFocus события являются событиями фокус низкого уровня, которые привязаны к сообщениям WM_KILLFOCUS и WM_SETFOCUS Windows.Note The GotFocus and LostFocus events are low-level focus events that are tied to the WM_KILLFOCUS and WM_SETFOCUS Windows messages. Как правило GotFocus и LostFocus события используются только в том случае, при обновлении UICues или при написании пользовательских элементов управления.Typically, the GotFocus and LostFocus events are only used when updating UICues or when writing custom controls. Вместо этого Enter и Leave событий следует использовать для всех элементов управления, за исключением Form класса, которая использует Activated и Deactivate события.Instead the Enter and Leave events should be used for all controls except the Form class, which uses the Activated and Deactivate events. Дополнительные сведения о GotFocus и LostFocus события, см. в разделе WM_SETFOCUS и WM_KILLFOCUS разделы.For more information about the GotFocus and LostFocus events, see the WM_SETFOCUS and WM_KILLFOCUS topics.

Внимание!

Не пытайтесь задать фокус из 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.

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

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

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