InteractionTracker.TryUpdatePosition Méthode

Définition

Espace de noms:

Windows.UI.Composition.Interactions

Surcharges

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	Tente de mettre à jour la position d’InteractionTracker à l’aide de l’option de verrouillage spécifiée.
TryUpdatePosition(Vector3)	Tente de mettre à jour la position d’InteractionTracker. La méthode TryUpdatePosition met à jour l’emplacement d’InteractionTracker à la position Vector3 spécifiée en tant que paramètre. TryUpdatePosition permet de définir de manière déclarative la position d’InteractionTracker à tout moment (au début, à partir d’un événement entré dans l’état, etc.). TryUpdatePosition peut être appelé à partir de l’état Inactif, CustomAnimation ou Inertie. Cela déplace la position d’InteractionTracker vers la position définie et passe à l’état inactif.
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)	Tente de mettre à jour la position d’InteractionTracker à l’aide de l’option de verrouillage spécifiée.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Tente de mettre à jour la position d’InteractionTracker à l’aide de l’option de verrouillage 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 InteractionTracker.

option

InteractionTrackerClampingOption

Valeur qui spécifie comment 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 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 2004 (introduit dans 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v10.0)

TryUpdatePosition(Vector3)

Tente de mettre à jour la position d’InteractionTracker.

La méthode TryUpdatePosition met à jour l’emplacement d’InteractionTracker à la position Vector3 spécifiée en tant que paramètre. TryUpdatePosition permet de définir de manière déclarative la position d’InteractionTracker à tout moment (au début, à partir d’un événement entré dans l’état, etc.). TryUpdatePosition peut être appelé à partir de l’état Inactif, CustomAnimation ou Inertie. Cela déplace la position d’InteractionTracker vers la position définie et passe à 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 InteractionTracker.

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

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 que TryUpdatePosition 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

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Tente de mettre à jour la position d’InteractionTracker à l’aide de l’option de verrouillage 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 InteractionTracker.

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)