InteractionTracker.TryUpdatePositionBy Méthode

  • Référence

Définition

Espace de noms:
Windows.UI.Composition.Interactions

Surcharges

TryUpdatePositionBy(Vector3)

Tente d’ajuster la position d’InteractionTracker selon le montant spécifié.

La méthode TryUpdatePositionBy met à jour l’emplacement actuel d’InteractionTracker par le delta Vector3 spécifié en tant que paramètre. De la même façon que TryUpdatePosition, TryUpdatePositionBy permet de déplacer de manière déclarative InteractionTracker par un delta défini sans avoir besoin d’une animation ou d’une inertie. TryUpdatePositionBy peut être appelé à partir de l’état Inactif, CustomAnimation ou Inertie. Cela déplace la position d’InteractionTracker par le delta défini et passe à l’état inactif.
TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Tente d’ajuster la position de l’Objet InteractionTracker en fonction de la quantité spécifiée à l’aide de l’option de serrage spécifiée.

TryUpdatePositionBy(Vector3)

Modifier

Tente d’ajuster la position d’InteractionTracker selon le montant spécifié.

La méthode TryUpdatePositionBy met à jour l’emplacement actuel d’InteractionTracker par le delta Vector3 spécifié en tant que paramètre. De la même façon que TryUpdatePosition, TryUpdatePositionBy permet de déplacer de manière déclarative InteractionTracker par un delta défini sans avoir besoin d’une animation ou d’une inertie. TryUpdatePositionBy peut être appelé à partir de l’état Inactif, CustomAnimation ou Inertie. Cela déplace la position d’InteractionTracker par le delta défini et passe à l’état inactif.

public:
 virtual int TryUpdatePositionBy(float3 amount) = TryUpdatePositionBy;
int TryUpdatePositionBy(float3 const& amount);
public int TryUpdatePositionBy(Vector3 amount);
function tryUpdatePositionBy(amount)
Public Function TryUpdatePositionBy (amount As Vector3) As Integer

Paramètres

amount
Vector3 Vector3

float3

Valeur à ajouter à la position actuelle.

Retours

Int32

int

Retourne l’ID de demande. Lors des transitions d’état, la demande qui a provoqué le changement d’état est incluse dans les arguments. Ces ID commencent à 1 et augmentent à chaque appel d’essai pendant la durée de vie de l’application.

Exemples

public void InertiaStateEntered(InteractionTracker sender, 	InteractionTrackerInertiaStateEnteredArgs args)
{
  // For sample purpose, will overwrite Inertia motion definitions by moving InteractionTracker to a specified position based on a delta
  _tracker.TryUpdatePositionBy(new Vector3(50f));}
}

Remarques

Si InteractionTracker est dans son état d’interaction (manipulation active de l’utilisateur) et que TryUpdatePositionBy est appelé, le système ignore cette requête : un événement est déclenché lorsque cela se produit et peut être écouté. S’il est envoyé à partir de l’un des autres états, écoutez l’événement déclenché pour IdleStateEntered et case activée la propriété RequestId qui identifie la demande 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
IdleMises à jour des propriétés de la valeur demandée, aucun changement d’état
InteractionDemande ignorée
InertieMises à jour de propriété de la valeur demandée, changement d’état en Inactif
CustomAnimationMises à jour de propriété de la valeur demandée, changement d’état en Inactif

S’applique à

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Modifier

Tente d’ajuster la position de l’Objet InteractionTracker en fonction de la quantité spécifiée à l’aide de l’option de serrage spécifiée.

public:
 virtual int TryUpdatePositionBy(float3 amount, InteractionTrackerClampingOption option) = TryUpdatePositionBy;
/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
int TryUpdatePositionBy(float3 const& amount, InteractionTrackerClampingOption const& option);
[Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
public int TryUpdatePositionBy(Vector3 amount, InteractionTrackerClampingOption option);
function tryUpdatePositionBy(amount, option)
Public Function TryUpdatePositionBy (amount As Vector3, option As InteractionTrackerClampingOption) As Integer

Paramètres

amount
Vector3 Vector3

float3

Valeur à ajouter à la position actuelle.

option
InteractionTrackerClampingOption

Valeur qui spécifie comment les valeurs sont limitées au maximum et au minimum.

Retours

Int32

int

Retourne l’ID de demande. Lors des transitions d’état, la demande qui a provoqué le changement d’état est incluse dans les arguments. Ces ID commencent à 1 et augmentent à chaque appel d’essai pendant la durée de vie de l’application.

Attributs
OverloadAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v7.0)

S’applique à