Freigeben über


UIElement.GotFocus Ereignis

Definition

Tritt auf, wenn ein UIElement den Fokus erhält. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist.

// Register
event_token GotFocus(RoutedEventHandler const& handler) const;

// Revoke with event_token
void GotFocus(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::GotFocus_revoker GotFocus(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler GotFocus;
function onGotFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gotfocus", onGotFocus);
uIElement.removeEventListener("gotfocus", onGotFocus);
- or -
uIElement.ongotfocus = onGotFocus;
Public Custom Event GotFocus As RoutedEventHandler 
<uiElement GotFocus="eventhandler"/>

Ereignistyp

Hinweise

Es wird empfohlen, nach Möglichkeit die UIElement-Fokusroutenereignisse anstelle von FocusManager-Ereignissen zu verwenden.

Nur ein einzelnes UI-Element gleichzeitig kann den Fokus haben.

Ein Steuerelement kann den Fokus erhalten, wenn ein anderes Steuerelement den Fokus verliert, sich die Anwendungsansicht ändert, der Benutzer die Anwendungen wechselt oder der Benutzer mit dem System interagiert, sodass sich die Anwendung nicht mehr im Vordergrund befindet.

LostFocus wird vor GotFocus ausgelöst.

Wenn Sie Steuerelementkompositierung oder Ui Compositing verwenden und GotFocus in einem Container wie panel oderGridView behandeln, sollten Sie die OriginalSource für die Ereignisdaten überprüfen, um zu bestimmen, welches Element in der Komposition tatsächlich den Fokus erhalten hat.

GotFocus verfügt über keine spezialisierten Ereignisdaten. Wenn Sie GotFocus behandeln, möchten Sie möglicherweise ermitteln, ob der Benutzer oder der App-Code dazu geführt hat, dass ein Element den Fokus erlangt hat. Um dies in Ihrem Handler zu ermitteln, wandeln Sie den Absender des Ereignisses in ein Control-Objekt um, und überprüfen Sie focusState.

Der Tastaturfokus ist besonders für die Behandlung von Tastaturereignissen relevant, da nur das derzeit tastaturorientierte UIElement die Quelle der KeyUp - und KeyDown-Tastenereignisse sein kann. Anwendungen können den Fokus als Initialisierungsaktion aufrufen, damit die Schlüsselereignisse in der App als Ganzes verwendet werden können, um Zugriffs- oder Zugriffstasten zu erkennen. Weitere Informationen finden Sie unter Tastaturinteraktionen.

GotFocus ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das GotFocus-Ereignis. Wenn dies der Grund ist, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die OnGotFocus-Methode. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das GotFocus-Ereignis wird nicht zur Behandlung von Benutzercodehandlern für dieses Steuerelement ausgelöst. Steuerelemente können das Ereignis behandeln, um eine eigenschaft des visuellen Zustands zu laden, die ein Fokusrechteck anzeigt.

Das Fokusrechteck eines Steuerelements ist eine wichtige visuelle Komponente, die den Zugriff erleichtert, indem das aktuelle fokussierte Element identifiziert und angegeben wird, wo sich der Benutzer in der Registerkartensequenz der Benutzeroberfläche der Anwendung befindet. In einigen Fällen ist der FocusState der Fokusaktion relevant, um zu bestimmen, ob ein sichtbarer Fokusindikator angezeigt werden soll.

Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung von Ereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse. Weitere Informationen zu Registerkartensequenzen und Barrierefreiheit finden Sie unter Tastaturzugriff.

Gilt für:

Weitere Informationen