Control.RemoveFocusEngagement Methode

Definition

Namespace:

Windows.UI.Xaml.Controls

Gibt den Fokus von den Steuerungsgrenzen für ein Steuerelement frei, das fokusaktiv ist (für Spielpad-/Remoteinteraktion).

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

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

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

Wenn die IsFocusEngagementEnabled-Eigenschaft auf true festgelegt ist, markiert sie das Steuerelement als Erforderlicher Fokuseinbindung. 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 davon wegzu navigieren. Sie können RemoveFocusEngagement aufrufen, um ein Steuerelement programmgesteuert zu deaktivieren.

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

Versionskompatibilität

Die RemoveFocusEngagement-Methode ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, rufen Sie diese Methode nicht auf, ohne zuvor eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Methode vorhanden ist, bevor Sie sie verwenden.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}