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

Définition

Se produit quand le contrôle reçoit le focus.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 
Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de GotFocus l’événement.In the example, an event handler reports on the occurrence of the GotFocus event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui Controlhérite de, Button tel ComboBoxque ou.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. Nommez ensuite l' Control1 instance et assurez-vous que le gestionnaire d' GotFocus événements est associé à l’événement.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

Remarques

Lorsque vous modifiez le focus à l’aide du clavier (Tab, Maj + Tab, etc.), en appelant les Select méthodes SelectNextControl ou, ou en définissant ContainerControl.ActiveControl la propriété sur le formulaire actuel, les événements de focus se produisent dans l’ordre suivant :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

Lorsque vous modifiez le focus à l’aide de la souris ou en Focus appelant la méthode, les événements de focus se produisent dans l’ordre suivant :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

Si la CausesValidation propriété a la falsevaleur, les Validating événements Validated et sont supprimés.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Remarque Les GotFocus événements LostFocus et sont des événements de focus de bas niveau qui sont liés aux messages Windows WM_KILLFOCUS et WM_SETFOCUS.Note The GotFocus and LostFocus events are low-level focus events that are tied to the WM_KILLFOCUS and WM_SETFOCUS Windows messages. En règle générale GotFocus , LostFocus les événements et sont utilisés uniquement lors UICues de la mise à jour ou lors de l’écriture de contrôles personnalisés.Typically, the GotFocus and LostFocus events are only used when updating UICues or when writing custom controls. Au lieu Enter de Leave cela, les événements et doivent être utilisés pour Form tous les contrôles, à l' Deactivate exception de la classe, qui utilise les Activated événements et.Instead the Enter and Leave events should be used for all controls except the Form class, which uses the Activated and Deactivate events. Pour plus d’informations sur GotFocus les LostFocus événements et, consultez les rubriques WM_SETFOCUS et WM_KILLFOCUS .For more information about the GotFocus and LostFocus events, see the WM_SETFOCUS and WM_KILLFOCUS topics.

Attention

N’essayez pas de définir le focus à partir Enterdes GotFocusgestionnaires d' LostFocusévénements Validating,, Validated Leave,, ou.Do not attempt to set focus from within the Enter, GotFocus, Leave, LostFocus, Validating, or Validated event handlers. Cela peut entraîner l’arrêt de la réponse de votre application ou du système d’exploitation.Doing so can cause your application or the operating system to stop responding. Pour plus d’informations, consultez la rubrique WM_KILLFOCUS .For more information, see the WM_KILLFOCUS topic.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi