Freigeben über


Control.GotFocus-Ereignis

Tritt ein, wenn das Steuerelement den Fokus erhält.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Event GotFocus As EventHandler
'Usage
Dim instance As Control
Dim handler As EventHandler

AddHandler instance.GotFocus, handler
public event EventHandler GotFocus
public:
event EventHandler^ GotFocus {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}
/** @event */
public void add_GotFocus (EventHandler value)

/** @event */
public void remove_GotFocus (EventHandler value)
JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Wenn Sie den Fokus mithilfe der Tastatur (TAB, UMSCHALT+TAB usw.), durch Aufrufen der Select-Methode oder der SelectNextControl-Methode oder durch Festlegen der ContainerControl.ActiveControl-Eigenschaft auf das aktuelle Formular ändern, treten die Fokusereignisse in der folgenden Reihenfolge ein:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Wenn Sie den Fokus mit der Maus oder durch Aufrufen der Focus-Methode ändern, treten die Fokusereignisse in der folgenden Reihenfolge ein:

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

Wenn die CausesValidation-Eigenschaft auf false festgelegt ist, wird das Validating-Ereignis und das Validated-Ereignis unterdrückt.

Hinweis   Das GotFocus-Ereignis und das LostFocus-Ereignis sind Fokusereignisse niedriger Ebene, die an die Windows-Meldungen WM_KILLFOCUS und WM_SETFOCUS gebunden sind. Das GotFocus-Ereignis und das LostFocus-Ereignis wird i. d. R. nur beim Aktualisieren von UICues oder beim Schreiben benutzerdefinierter Steuerelemente verwendet. Stattdessen sollten das Enter-Ereignis und das Leave-Ereignis für alle Steuerelemente außer der Form-Klasse verwendet werden, die das Activated-Ereignis und das Deactivate-Ereignis verwendet. Weitere Informationen zum GotFocus-Ereignis und zum LostFocus-Ereignis finden Sie in den Themen WM_SETFOCUS und WM_KILLFOCUS in der MSDN Library im Abschnitt "Keyboard Input Reference" der Platform SDK-Dokumentation unter https://msdn.microsoft.com/library/deu.

Warnung

Legen Sie den Fokus nicht vom LostFocus-Ereignishandler aus fest. Andernfalls reagiert die Anwendung oder das Betriebssystem möglicherweise nicht mehr. Weitere Informationen zum LostFocus-Ereignis finden Sie in der MSDN Library im Abschnitt "Keyboard Input Reference" unter dem Thema WM_KILLFOCUS und in der Platform SDK-Dokumentation der MSDN Library im Abschnitt "Messages and Messages Queues" unter dem Thema Message Deadlocks unter https://msdn.microsoft.com/library/deu.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
OnGotFocus
LostFocus
Control.Enter-Ereignis
Form.Activated
Form.Activate