Control.GotFocus Événement

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 l’événement GotFocus.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 hérite de Control, tel qu’un Button ou 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. Nommez ensuite l’instance Control1 et assurez-vous que le gestionnaire d’événements est associé à l’événement 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

Remarques

Lorsque vous modifiez le focus à l’aide du clavier (TAB, MAJ + TAB, etc.), en appelant les méthodes Select ou SelectNextControl, ou en définissant la propriété ContainerControl.ActiveControl 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 appelant la méthode Focus, 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 propriété CausesValidation est définie sur false, les événements Validating et Validated sont supprimés.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Remarque Les événements GotFocus et LostFocus 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, les événements GotFocus et LostFocus sont utilisés uniquement lors de la mise à jour de UICues 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 de cela, les événements Enter et Leave doivent être utilisés pour tous les contrôles, à l’exception de la classe Form, qui utilise les événements Activated et Deactivate.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 les événements GotFocus et LostFocus, 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 des gestionnaires d’événements Enter, GotFocus, Leave, LostFocus, Validating ou Validated.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