Partager via


InteractionTracker.TryUpdatePosition Méthode

Définition

Surcharges

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Tente de mettre à jour la position du InteractionTracker à l’aide de l’option de pince spécifiée.

TryUpdatePosition(Vector3)

Tente de mettre à jour la position duinteractionTracker .

La méthode TryUpdatePosition met à jour l’emplacement de InteractionTracker à la position Vector3 spécifiée en tant que paramètre. TryUpdatePosition est utilisé pour définir de manière déclarative la position de InteractionTracker à tout moment (à partir d’un événement entré à l’état, etc.). TryUpdatePosition peut être appelé à partir de l’état Inactive, CustomAnimation ou Inertie. Cela permet de déplacer la position de InteractionTracker vers la position définie et d’entrer l’état inactif.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Tente de mettre à jour la position du InteractionTracker à l’aide de l’option de pince spécifiée.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Tente de mettre à jour la position du InteractionTracker à l’aide de l’option de pince spécifiée.

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption) = TryUpdatePosition;
/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option, InteractionTrackerPositionUpdateOption const& posUpdateOption);
[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption);
function tryUpdatePosition(value, option, posUpdateOption)
Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption, posUpdateOption As InteractionTrackerPositionUpdateOption) As Integer

Paramètres

value
Vector3 Vector3

float3

Nouvelle position pour leInteractionTracker .

option
InteractionTrackerClampingOption

Valeur qui spécifie la façon dont les valeurs sont limitées au maximum et au minimum.

posUpdateOption
InteractionTrackerPositionUpdateOption

Valeur qui spécifie si une animation de mise à l’échelle personnalisée déjà en cours d’exécution doit être autorisée à continuer à s’exécuter.

Retours

Int32

int

Retourne l’ID de requête. Lors des transitions d’état, la requête qui a provoqué la modification de l’état sera incluse dans les arguments. Ces ID commencent à 1 et augmentent avec chaque appel d’essai pendant la durée de vie de l’application.

Attributs

S’applique à

TryUpdatePosition(Vector3)

Tente de mettre à jour la position duinteractionTracker .

La méthode TryUpdatePosition met à jour l’emplacement de InteractionTracker à la position Vector3 spécifiée en tant que paramètre. TryUpdatePosition est utilisé pour définir de manière déclarative la position de InteractionTracker à tout moment (à partir d’un événement entré à l’état, etc.). TryUpdatePosition peut être appelé à partir de l’état Inactive, CustomAnimation ou Inertie. Cela permet de déplacer la position de InteractionTracker vers la position définie et d’entrer l’état inactif.

public:
 virtual int TryUpdatePosition(float3 value) = TryUpdatePosition;
int TryUpdatePosition(float3 const& value);
public int TryUpdatePosition(Vector3 value);
function tryUpdatePosition(value)
Public Function TryUpdatePosition (value As Vector3) As Integer

Paramètres

value
Vector3 Vector3

float3

Nouvelle position pour leInteractionTracker .

Retours

Int32

int

Retourne l’ID de requête. Lors des transitions d’état, la requête qui a provoqué la modification de l’état sera incluse dans les arguments. Ces ID commencent à 1 et augmentent avec chaque appel d’essai pendant la durée de vie de l’application.

Exemples

void SetupInteractionTracker()
{
  // Setup InteractionTracker
  _tracker = InteractionTracker.Create(_compositor);
  _interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  _interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(_interactionSource);
  _tracker.PositionInertiaDecayRate = new Vector3(0.95f);

  // Update the position of InteractionTracker, so doesn’t start at (0,0)
  _tracker.TryUpdatePosition(new Vector3(50f));
}

Remarques

Si InteractionTracker est dans son état d’interaction (manipulation active de l’utilisateur) et TryUpdatePosition est appelé, le système ignore cette demande : un événement est déclenché lorsque cela se produit qui peut être écouté. Si elle est envoyée à partir de l’un des autres états, écoutez l’événement déclenché pour IdleStateEntered et vérifiez la propriété RequestId qui identifie la requête qui a déclenché le rappel. Le tableau ci-dessous récapitule le comportement attendu lorsque cette méthode est appelée dans un état particulier :

État actuelRésultat
OisifMises à jour des propriétés pour la valeur demandée, aucune modification de l’état
InteractionDemande ignorée
InertieMises à jour des propriétés pour la valeur demandée, les modifications d’état apportées à Inactif
CustomAnimationMises à jour des propriétés pour la valeur demandée, les modifications d’état apportées à Inactif

S’applique à

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Tente de mettre à jour la position du InteractionTracker à l’aide de l’option de pince spécifiée.

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option) = TryUpdatePosition;
/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option);
[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option);
function tryUpdatePosition(value, option)
Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption) As Integer

Paramètres

value
Vector3 Vector3

float3

Nouvelle position pour leInteractionTracker .

option
InteractionTrackerClampingOption

Valeur qui spécifie la façon dont les valeurs sont limitées au maximum et au minimum.

Retours

Int32

int

Retourne l’ID de requête. Lors des transitions d’état, la requête qui a provoqué la modification de l’état sera incluse dans les arguments. Ces ID commencent à 1 et augmentent avec chaque appel d’essai pendant la durée de vie de l’application.

Attributs

S’applique à