InteractionTracker.TryUpdatePositionBy Méthode

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)

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 actuel	Résultat
Idle	Mises à jour des propriétés de la valeur demandée, aucun changement d’état
Interaction	Demande ignorée
Inertie	Mises à jour de propriété de la valeur demandée, changement d’état en Inactif
CustomAnimation	Mises à jour de propriété de la valeur demandée, changement d’état en 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.

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)