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 des rapports sur l’occurrence de la GotFocus é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 à déboguer.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, comme 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. Ensuite, nommez l’instance Control1 et vous assurer que le Gestionnaire d’événements est associé à la GotFocus é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 (onglet, MAJ + TAB et ainsi de suite), en appelant le Select ou SelectNextControl méthodes, ou en définissant le ContainerControl.ActiveControl propriété au formulaire actuel, le 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 le Focus (méthode), le 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 le CausesValidation propriété est définie sur false, le Validating et Validated les événements sont supprimés.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Remarque le GotFocus et LostFocus les événements sont des événements de focus de bas niveau qui sont liés aux messages WM_KILLFOCUS et 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. En règle générale, le GotFocus et LostFocus événements sont uniquement utilisés lorsque la mise à jour UICues ou lors de l’écriture des contrôles personnalisés.Typically, the GotFocus and LostFocus events are only used when updating UICues or when writing custom controls. À la place la Enter et Leave événements doivent être utilisés pour tous les contrôles à l’exception de la Form classe, qui utilise le Activated et Deactivate événements.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 la GotFocus et LostFocus les événements, consultez le WM_SETFOCUS et WM_KILLFOCUS rubriques.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 depuis le Enter, GotFocus, Leave, LostFocus, Validating, ou Validated gestionnaires d’événements.Do not attempt to set focus from within the Enter, GotFocus, Leave, LostFocus, Validating, or Validated event handlers. Cela peut entraîner votre application ou le système d’exploitation cesse de répondre.Doing so can cause your application or the operating system to stop responding. Pour plus d’informations, consultez le WM_KILLFOCUS rubrique.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