Partager via

InteractionTracker.TryUpdatePosition Méthode

  • Référence

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)

Modifier

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)

S’applique à

TryUpdatePosition(Vector3)

Modifier

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 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 à

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Modifier

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)

S’applique à