SpatialInteractionSourceState.TryGetPointerPose Methode

Definition

Namespace:

Windows.UI.Input.Spatial

Ruft die verfügbaren Zeigerhaltungen ab, z. B. den Kopfausdruck des Benutzers, den Blick und die Zeigerhaltung jedes Bewegungscontrollers für den Zeitstempel, zu dem dieser Zustand Momentaufnahme wurde.

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

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 der Kopfanzeige des Benutzers als Ziel verwendet werden, die ü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.