SpatialManipulationStartedEventArgs.TryGetPointerPose Methode

Definition

Ruft die verfügbaren Zeigerhaltungen ab, z. B. den Kopfblick 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

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 Handbewegung, eine Bewegungscontroller-Druck- oder Sprachinteraktion, sollten Apps basierend auf der Art der SpatialInteractionSource der Interaktion einen zeigenden Strahl auswählen, der aus dem SpatialPointerPose der Interaktion verfügbar ist:

  • Wenn die Interaktionsquelle das Zeigen nicht unterstützt (IsPointingSupported ist false), sollte die App ein Ziel basierend auf dem Blick des Benutzers verwenden, das über die Head-Eigenschaft verfügbar ist.
  • Wenn die Interaktionsquelle das Pointing 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 zeigenden Strahl mit 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.

Gilt für: