Control.FocusDisengaged Ereignis

Definition

Namespace:

Windows.UI.Xaml.Controls

Tritt auf, wenn der Fokus von den Steuerungsgrenzen (für Gamepad/Remoteinteraktion) aufgehoben wird.

// Register
event_token FocusDisengaged(TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
Control::FocusDisengaged_revoker FocusDisengaged(auto_revoke_t, TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

public event TypedEventHandler<Control,FocusDisengagedEventArgs> FocusDisengaged;

function onFocusDisengaged(eventArgs) { /* Your code */ }
control.addEventListener("focusdisengaged", onFocusDisengaged);
control.removeEventListener("focusdisengaged", onFocusDisengaged);
- or -
control.onfocusdisengaged = onFocusDisengaged;

Public Custom Event FocusDisengaged As TypedEventHandler(Of Control, FocusDisengagedEventArgs) 

<control FocusDisengaged="eventhandler"/>

Ereignistyp

TypedEventHandler<Control,FocusDisengagedEventArgs>

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Ereignisdaten finden Sie unter FocusDisengagedEventArgs.

Das Fokus-Engagement erleichtert die Verwendung eines Spielpads oder einer Fernbedienung für die Interaktion mit einer App. Das Festlegen des Fokuseinsatzes wirkt sich nicht auf Tastatur oder andere Eingabegeräte aus.

Wenn die IsFocusEngagementEnabled-Eigenschaft auf true festgelegt ist, markiert sie das Steuerelement als erforderlich für den Fokus. Das bedeutet, dass der Benutzer die A/Select-Taste (Auswahl-Taste) drücken muss, um das Steuerelement zu „aktivieren“ und mit diesem zu interagieren. Wenn sie fertig sind, können sie die Schaltfläche B/Zurück drücken, um das Steuerelement zu deaktivieren und von diesem weg zu navigieren.

Weitere Informationen finden Sie im Abschnitt Fokusbindung des Artikels Entwerfen für Xbox und TV .

Versionskompatibilität

Das FocusDisengaged-Ereignis ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, verbinden Sie dieses Ereignis nicht, ohne zuerst eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieses Ereignisses zu überprüfen, bevor Sie es verwenden.

<Slider x:Name="slider1" Loaded="Slider_Loaded"/>

private void Slider_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.Control", "FocusDisengaged"))
    {
        slider1.FocusDisengaged += Slider1_FocusDisengaged;
    }
}