Control.RequiresPointer Eigenschaft

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Controls
Bearbeiten

Ruft ab oder legt fest, ob ein UI-Element den Mausmodus unterstützt, der Zeigerinteraktionsfunktionen mit Nicht-Zeiger-Eingabegeräten wie einem Spielpad oder einer Fernbedienung emuliert.

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };
RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);
public RequiresPointer RequiresPointer { get; set; }
var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;
Public Property RequiresPointer As RequiresPointer
<control RequiresPointer="requiresPointerMemberName"/>

Eigenschaftswert

RequiresPointer

Der Zeigeremulationsmodus. Der Standardwert ist Nie.

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

Bei Nicht-Zeiger-Eingabegeräten wird der Fokus zwischen Steuerelementen über eine Vielzahl von Methoden verschoben, z. B. die TAB- und PFEILTASTEn auf einer Tastatur, das Direktionalpad (D-Pad) auf einer Fernbedienung oder Daumensticks auf einem Gamecontroller. Für einige Benutzeroberflächen, z. B. Karten und Zeichnungsoberflächen, ist es nicht möglich oder praktisch, die XY-Fokusnavigation zu verwenden. Mit RequiresPointer kann eine App eine eher zeigerähnliche Interaktion über einen Cursor bereitstellen, der mithilfe von Spieleingabegeräten frei bewegt werden kann.

RequiresPointer wird nur auf der Xbox-Gerätefamilie und nur bei Verwendung eines Gamepads oder einer Fernbedienung unterstützt. Die -Eigenschaft wird andernfalls ignoriert.

RequiresPointerMode legt den Mausmodus auf Anwendungsebene fest.

Weitere Informationen finden Sie im Abschnitt Mausmodus unter Entwerfen für Xbox und TV.

Versionskompatibilität

Die RequiresPointer-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", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

Gilt für:

Weitere Informationen