SpatialNavigationStartedEventArgs.TryGetPointerPose Methode

Definition

Namespace:

Windows.UI.Input.Spatial

Ruft die verfügbaren Zeigerhaltungen ab, z. B. den Kopfausblick des Benutzers und die Zeigerhaltung jedes Bewegungscontrollers, um diese Geste als Ziel zu verwenden.

public:
 virtual SpatialPointerPose ^ TryGetPointerPose(SpatialCoordinateSystem ^ coordinateSystem) = TryGetPointerPose;

SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem const& coordinateSystem);

public SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem coordinateSystem);

function tryGetPointerPose(coordinateSystem)

Public Function TryGetPointerPose (coordinateSystem As SpatialCoordinateSystem) As SpatialPointerPose

Parameter

coordinateSystem

SpatialCoordinateSystem

Das Koordinatensystem, in dem die Zeigerhaltungen ausgedrückt werden sollen.

Gibt zurück

SpatialPointerPose

Der Zeiger posiert.

Hinweise

Diese Pose stammt aus dem Zeitstempel der anfänglichen SpatialInteraction, die an diese Erkennung weitergeleitet wird, um die aktive Geste zu starten.

Bei der Ausrichtung auf eine räumliche Interaktion, z. B. eine Handgeste, eine Bewegungscontroller-Druck- oder Sprachinteraktion, sollten Apps basierend auf der Art der SpatialInteractionSource der Interaktion einen aus dem SpatialPointerPose der Interaktion verfügbaren Zeigerstrahl auswählen:

• Wenn die Interaktionsquelle das Zeigen nicht unterstützt (IsPointingSupported ist false), sollte die App basierend auf dem Blick des Benutzers als Ziel verwendet werden, das über die Head-Eigenschaft verfügbar ist.
• Wenn die Interaktionsquelle das Verweisen unterstützt (IsPointingSupported ist true), kann die App stattdessen basierend auf der Zeigerposition der Quelle als Ziel verwendet werden, die über die TryGetInteractionSourcePose-Methode verfügbar ist.

Die App sollte dann den ausgewählten Zeigestrahl mit ihren eigenen Hologrammen oder mit dem räumlichen Zuordnungsgitter überschneiden, um Cursor zu rendern und zu bestimmen, womit der Benutzer interagieren möchte.

Sobald eine Interaktion gestartet wurde, können relative Bewegungen der Hand oder des Controllers verwendet werden, um die Geste zu steuern, wie bei der Bearbeitungs- oder Navigationsgeste.

Diese Methode gibt NULL zurück, wenn das angegebene Koordinatensystem derzeit nicht gefunden werden kann.