Control.IsFocusEngagementEnabled Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Abrufen oder Festlegen eines Werts, der angibt, ob der Fokus innerhalb der Steuerungsgrenzen eingeschränkt werden kann (für Spielpad/Remoteinteraktion).
public:
property bool IsFocusEngagementEnabled { bool get(); void set(bool value); };bool IsFocusEngagementEnabled();
void IsFocusEngagementEnabled(bool value);public bool IsFocusEngagementEnabled { get; set; }var boolean = control.isFocusEngagementEnabled;
control.isFocusEngagementEnabled = boolean;Public Property IsFocusEngagementEnabled As Boolean<control IsFocusEngagementEnabled="bool"/>
Eigenschaftswert
bool
true , wenn der Fokus innerhalb der Steuerungsgrenzen eingeschränkt werden kann; Andernfalls false.
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
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 zu dieser Eigenschaft finden Sie im Abschnitt Fokusbindung des Artikels Entwerfen für Xbox und TV .
Versionskompatibilität
Die IsFocusEngagementEnabled-Eigenschaft 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, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieser Eigenschaft zu überprüfen, bevor Sie sie festlegen.
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngagementEnabled"))
{
slider1.IsFocusEngagementEnabled = true;
}