SpatialManipulationStartedEventArgs.TryGetPointerPose Methode
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.
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.