Partager via


InteractionTracker Classe

Définition

Gère la logique d’entrée qui peut être utilisée comme cibles dans ExpressionAnimations, généralement pour piloter le mouvement des visuels en fonction de l’entrée.

public ref class InteractionTracker sealed : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InteractionTracker final : CompositionObject
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class InteractionTracker final : CompositionObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InteractionTracker : CompositionObject
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class InteractionTracker : CompositionObject
Public NotInheritable Class InteractionTracker
Inherits CompositionObject
Héritage
Object Platform::Object IInspectable CompositionObject InteractionTracker
Attributs

Exemples

void SetupSimpleInteractionTracker(Visual viewportVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position and scale.  These could 
  // also be bound to expressions.  Note: The scrollable area can be changed from either 
  // the min or the max position to facilitate content updates/virtualization.
  //

  _tracker = InteractionTracker.Create(_compositor);

  _tracker.MaxPosition = new Vector3(
    contentVisual.Size.X - viewportVisual.Size.X,
    contentVisual.Size.Y - viewportVisual.Size.Y,
    0.0f);

  _tracker.MinScale = 0.5f;
  _tracker.MaxScale = 4.0f;


  //
  // Configure the interaction source.  Enable input with inertia on all axes.
  //

  var interactionSource = VisualInteractionSource.Create(viewportVisual);

  interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.ScaleSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(interactionSource);


  //
  // Bind the InteractionTracker outputs to the contentVisual.
  //

  var positionExpression = _compositor.CreateExpressionAnimation("-tracker.Position");
  positionExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Offset", positionExpression);


  var scaleExpression = _compositor.CreateExpressionAnimation("Vector3(tracker.Scale, tracker.Scale, 1.0)");

  scaleExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Scale", scaleExpression);
}


Remarques

interactionTracker est un ordinateur d’état qui peut être piloté par une entrée active, ou par des appels explicites pour mettre à jour ou animer ses propriétés. La classe InteractionTracker est destinée à permettre à l’entrée de conduire CompositionAnimations pour des expériences d’interaction personnalisées. Pour créer des expériences interactives, il est nécessaire d’associer un ou plusieurs VisualInteractionSourceauxInteractionTracker .

Scénarios courants

IneractionTracker est destiné à être utilisé pour :

  • Ajout d’un comportement de balayage personnalisé, par exemple le balayage d’éléments ListView ou d’autres visuels pour supprimer/ignorer
  • Transitions liées au mouvement panoramique, par exemple le balayage vers la transition entre les états « fermés » et « ouverts ».
  • L’animation pilotée par l’entrée d’un effet, par exemple le panoramique entraîne le flou de l’écran
  • Contrôles personnalisés, par exemple la création d’une implémentation personnalisée d’un ScrollViewer avec des vitesses de panoramique différentes ou la possibilité de contrôler par programmation

États et transitions InteractionTracker

InteractionTracker est un ordinateur d’état avec quatre états :

  • Inactif : aucune entrée ou animation active qui entraîne l’InteractionTracker
  • Interaction : l’entrée utilisateur active pilote l’InteractionTracker
  • Inertie : les animations actives qui résultent d’une entrée active ou d’une vitesse de programmation entraînent l’InteractionTracker
  • CustomAnimation : Une propriété de l’InteractionTracker est directement animée Le diagramme ci-dessous montre ces quatre états et quelles transitions d’état sont valides.
États InteractionTracker : Inactif, Inertie, Interaction et Animation personnalisée

Les transitions d’état peuvent se produire en raison d’actions utilisateur (telles que le démarrage ou l’arrêt d’une manipulation) ou d’appels explicites aux méthodes sur InteractionTracker. Chaque fois qu’un de ces appels explicites est effectué, un requestID est émis pour le suivi si la demande est ignorée ou provoque une modification d’état.

Il est important de noter que InteractionTracker s’exécute dans un processus différent de l’application qui l’utilise. Par conséquent, tous les appels de méthode sur InteractionTracker et les classes associées sont asynchrones, comme les rappels émis via l’interface IInteractionTrackerOwner.

Les éléments suivants décrivent ce qui déclenche chaque modification d’état à effectuer :

État de débutÉtat finalDéclencheurs possibles
OisifInteractionCette transition d’état se produit uniquement lorsqu’une manipulation utilisateur qui s’aligne avec un VisualInteractionSource associé à InteractionTracker est en cours d’exécution.
OisifInertieCette transition d’état se produit uniquement lorsque l’InteractionTracker est dans l’état Inactif et TryUpdatePositionWithVelocity ou TryUpdateScaleWithVelocity est appelé.
OisifCustomAnimationCette transition d’état se produit lorsque InteractionTracker est dans l’état inactif et TryUpdatePositionWithAnimation ou TryUpdateScaleWithAnimation est appelé.
InteractionInertieCette transition d’état se produit uniquement lorsqu’une manipulation utilisateur qui a été envoyée à InteractionTracker se termine. Lorsque l’entrée active se termine, InteractionTracker entre dans l’état d’inertie et des informations telles que la vitesse de libération du doigt et l’inertieDecayRate détermine le comportement pendant l’état d’inertie.
InertieOisifCette transition d’état se produit lorsque la ou les fonctions utilisées pour mettre à jour la position et/ou l’échelle ne provoquent plus de modification. En d’autres termes, la position et la vitesse d’échelle ont tous deux atteint zéro. Cette transition d’état peut également se produire si un appel est effectué pour mettre à jour explicitement la position ou l’échelle sans animation ou vitesse. Ces appels terminent l’inertie et passent à Idle avec les valeurs de propriété mises à jour.
InertieInertieCette transition d’état se produit lorsque TryUpdatePositionWithVelocity ou TryUpdateScaleWithVelocity est appelé lorsqu’il est déjà dans l’état Inertie. La saisie à nouveau de l’inertie entraîne la réévaluation de toutes les propriétés InertiaStateEntered.
InertieCustomAnimationCette transition d’état se produit lorsqu’un appel à TryUpdatePositionWithAnimation ou TryUpdateScaleWithAnimation est effectué pendant que l’inertie sate.
InertieInteractionCette transition d’état se produit lorsque l’entrée active de l’utilisateur qui effectue des tests de positionnement vers VisualInteractionSource se produit avant la fin de l’inertie.
CustomAnimationOisifCette transition d’état se produit lorsque toutes les animations définies sur la position et les propriétés d’échelle d’InteractionTracker sont terminées.
CustomAnimationCustomAnimationCette transition d’état se produit lorsqu’un appel à TryUpdatePositionWithAnimation ou TryUpdateScaleWithAnimation est effectué alors qu’il est déjà dans l’état CustomAnimation.
CustomAnimationInertieCette transition d’état se produit lorsqu’un appel à TryUpdatePositionWithVelocity ou TryUpdateScaleWithVelocity est effectué lors de l’état CustomAnimation.
CustomAnimationInteractionCette transition d’état se produit lorsqu’une manipulation utilisateur qui effectue des tests de positionnement vers visualInteractionSource associée à InteractionTracker est en cours d’exécution.

Toute transition d’état effectuée par InteractionTracker génère un rappel indiquant le nouvel état avec des arguments qui incluent des informations pertinentes pour cet état, ainsi que l’ID de requête pour la demande qui a provoqué la modification de l’état. Les manipulations actives de l’utilisateur entraînent un ID de requête de 0. Tout appel Try* émet un ID de requête qui peut être utilisé pour le suivi de l’appel Try* à l’origine du changement d’état. Le premier ID de requête pendant la durée de vie de l’application est 1, et chaque appel suivant incrémente l’ID de requête, ce qui signifie que chacun sera unique.

Position et mise à l’échelle d’InteractionTracker

Les deux propriétés les plus couramment utilisées de l’InteractionTracker sont de position et d’échelle. Chaque fois qu’une modification est apportée à l’une ou l’autre de ces propriétés, le rappel ValuesChanged est envoyé avec des informations sur les valeurs actuelles. En raison de la nature asynchrone d’InteractionTracker, les valeurs reçues via les rappels InteractionTracker sont la meilleure façon de mettre à jour la logique d’application sur l’état actuel et les valeurs d’InteractionTracker et de ses propriétés.

Une distinction importante au sujet de l’InteractionTracker est que sa position et son échelle ne sont pas associées à l’espace de coordonnées d’un visuel particulier. Au moment de la création de l’InteractionTracker, sa position aura les sous-canaux x, y et z du jeu de vecteurs sur 0, et l’échelle sera définie sur 1. Seuls les appels d’entrée actif ou Try* peuvent entraîner la modification de ces valeurs. Les valeurs minimales et maximales pour chaque propriété déterminent la plage dans laquelle les valeurs peuvent varier. L’une des exceptions est le concept de « overpan » ou de « overzoom », où une manipulation active peut entraîner des valeurs légèrement au-delà du minimum ou du maximum pendant l’état d’interaction. Une fois la manipulation terminée, toutefois, les valeurs sont toujours mises au repos dans la plage définie. Les customAnimations sont toujours limitées dans les plages définies pour la position et l’échelle.

Le concept d’espace de coordonnées InteractionTracker s’aligne sur le concept de coordonnées de l’écran dans lequel un mouvement haut/gauche augmente la valeur de position et un mouvement bas/droit diminue la valeur de position. Par conséquent, il est très courant de négation de la propriété position lors de son attachement à l’offset d’un visuel.

Par défaut, les canaux de position minimale et maximale sont tous 0, et les valeurs d’échelle minimale et maximale sont 1. Si le comportement souhaité pour l’une ou l’autre propriété est de l’autoriser à changer en dehors de ces valeurs de départ, les valeurs minimales/maximales doivent être mises à jour.

InteractionTracker et ExpressionAnimations

InteractionTracker expose une variété de propriétés qui peuvent être utilisées dans le contexte de ExpressionAnimations pour générer des mises à jour vers des propriétés animatables de CompositionObject s. En raison de la nature asynchrone d’InteractionTracker, il n’est pas recommandé d’interroger ces propriétés directement. Au lieu de cela, vous devez utiliser les propriétés fournies dans les rappels pour la conduite de la logique d’application et pour référencer les valeurs d’une ExpressionAnimation pour mettre à jour les propriétés animatables.

Comme mentionné ci-dessus, les deux propriétés les plus couramment utilisées de l’InteractionTracker sont les propriétés Position et Scale. Il s’agit des propriétés qui seront mises à jour en réponse aux appels d’entrée utilisateur et Try*. L’utilisation de ces propriétés dans ExpressionAnimations entraîne la mise à jour des propriétés animatables de CompositionObjects en réponse. Par exemple, la propriété InteractionTracker.position peut être liée à l’offset d’un visuel. Il est également courant d’utiliser ces propriétés pour remplir un CompositionPropertySet qui suit la progression, ce qui peut à son tour conduire une série d’animations coordonnées.

Directing Input to the InteractionTracker

Après avoir été configuré, InteractionTracker nécessite toujours une dernière étape pour recevoir réellement l’entrée tactile et répondre. Consultez la documentation sur VisualInteractionSource.TryRedirectForManipulation pour plus d’informations sur la configuration de l’entrée entrante à passer dans InteractionTracker.

Propriétés

Comment

Chaîne à associer au CompositionObject.

(Hérité de CompositionObject)
Compositor

Le compositor utilisé pour créer cette CompositionObject.

(Hérité de CompositionObject)
DispatcherQueue

Obtient le DispatcherQueue pour CompositionObject.

(Hérité de CompositionObject)
ImplicitAnimations

Collection d’animations implicites attachées à cet objet.

(Hérité de CompositionObject)
InteractionSources

Collection d’objets qui génèrent des interactions.

IsInertiaFromImpulse

Obtient une valeur qui indique si l’inertie est le résultat d’une impulsion.

IsPositionRoundingSuggested

Valeur booléenne indiquant si l’arrondi de position est actuellement suggéré.

MaxPosition

Position maximale autorisée pour leInteractionTracker .

MaxScale

Mise à l’échelle maximale pour leInteractionTracker .

MinPosition

Position minimale autorisée pour leInteractionTracker .

MinScale

Mise à l’échelle minimale pour leInteractionTracker .

NaturalRestingPosition

Position de repos naturelle pour leInteractionTracker .

La propriété NaturalRestingPosition est la position calculée à laquelle InteractionTracker viendra à un arrêt sans prendre en compte les limites ou les modificateurs d’inertie. Cette propriété est souvent utile pour les actions telles que la virtualisation dans une expérience de défilement, où il est important de connaître l’emplacement où InteractionTracker s’arrêtera. Il existe deux cas d’usage principaux pour l’utilisation de la propriété NaturalRestingPosition : récupération de sa valeur actuelle dans l'InertieStateEntered arguments d’événement ou référence de cette propriété dans un ExpressionAnimation lors de la création d’éléments tels que des modificateurs d’inertie.

NaturalRestingScale

Échelle de repos naturelle pour leInteractionTracker .

La propriété NaturalRestingScale est la position d’échelle calculée qui InteractionTracker viendra à un arrêt sans prendre en compte les limites ou les modificateurs d’inertie. Cette propriété est souvent utile pour les actions telles que la virtualisation dans une expérience de défilement, où il est important de connaître l’emplacement où InteractionTracker s’arrêtera. Il existe deux cas d’usage principaux pour l’utilisation de la propriété NaturalRestingScale : récupération de sa valeur actuelle dans les arguments d’événement InertiaStateEntered ou référencer cette propriété dans un ExpressionAnimation lors de la création d’éléments tels que des modificateurs d’inertie.

Owner

L'IInteractionTrackerOwner associé auInteractionTracker .

Position

Position de sortie calculée par l'InteractionTracker . La position actuelle est une valeur relative. Pendant les états Idle et CustomAnimation, il sera toujours entre les valeurs spécifiées dans les propriétés MinPosition et MaxPosition. La propriété de position d’InteractionTracker peut sortir de cette plage pendant les états d’interaction et d’inertie afin d’afficher un rebond ou une résistance au niveau de la limite.

La propriété position de l’InteractionTracker est une position Vector3 représentant la position dans l’axe X, Y et Z. Les canaux X et Y sont les seuls composants qui seront mis à jour par InteractionTracker à ce stade. Les canaux de ce Vector3 ne varient pas en dehors de 0 (valeur par défaut) si minPosition et MaxPosition ne sont pas définis.

PositionInertiaDecayRate

Taux de décroissance de l’inertie pour la position. La plage est comprise entre 0 et 1.

La propriété PositionInertiaDecayRate définit le taux auquel InteractionTracker ralentit jusqu’à un arrêt lorsqu’il a entré Inertie et position change. Le plus proche de 1, plus InteractionTracker ralentira jusqu’à un arrêt et inversement. Défini en tant que Vector3, chaque composant représente le taux de dégradation de l’inertie pour x, y, z en conséquence.

PositionVelocityInPixelsPerSecond

Vitesse actuellement appliquée à la position.

La propriété PositionVelocityInPixelsPerSecond représente la vitesse de position actuelle de InteractionTracker pendant l’inertie. Il existe deux cas d’usage principaux pour cette propriété : récupération de la vitesse de position de InteractionTracker juste après qu’une interaction s’est produite ou référence la vitesse la plus actuelle de InteractionTracker dans un ExpressionAnimation.

Properties

Collection de propriétés associées au CompositionObject.

(Hérité de CompositionObject)
Scale

Échelle de sortie calculée par l'InteractionTracker . L’échelle actuelle est une valeur relative qui dépend des valeurs spécifiées dans les propriétés MinScale et MaxScale.

La propriété d’échelle de l'InteractionTracker est un float représentant l’échelle dans l’espace de coordonnées de InteractionTracker. Cette valeur commence à 1 et augmente ou diminue en fonction des appels actifs ou directs pour mettre à jour ou animer la propriété. La propriété de mise à l’échelle lorsque le InteractionTracker se trouve dans les états Inactifs ou CustomAnimation ne change pas de 1, sauf si les propriétés MinScale et MaxScale, dont la valeur par défaut est 1, sont mises à jour. InteractionTracker 's scale can go légèrement en dehors de cette plage pendant les états d’Interaction et d’Inertie afin d’afficher un rebond ou une résistance à la limite.

ScaleInertiaDecayRate

Taux de dégradation de l’inertie, pour l’échelle. La plage est comprise entre 0 et 1.

La propriété ScaleInertiaDecayRate définit le taux auquel InteractionTracker ralentit jusqu’à un arrêt lorsqu’il a entré Inertie et que l’échelle change. Le plus proche de 1, plus InteractionTracker ralentira jusqu’à un arrêt et inversement. Contrairement au PositionInertiaDecayRate qui est défini en tant que Vector3, ScaleInertiaDecayRate est défini comme un seul float.

ScaleVelocityInPercentPerSecond

Taux de modification pour la mise à l’échelle.

La propriété ScaleVelocityInPercentPerSecond représente la vitesse d’échelle actuelle de InteractionTracker pendant l’inertie. Saisir la vitesse de position de InteractionTracker juste après qu’une interaction s’est produite ou référencer la vitesse la plus actuelle de InteractionTracker dans unExpressionAnimation .

Méthodes

AdjustPositionXIfGreaterThanThreshold(Single, Single)

Ajuste la coordonnée x position si elle est supérieure au seuil spécifié.

AdjustPositionYIfGreaterThanThreshold(Single, Single)

Ajuste la coordonnée y de position si elle est supérieure au seuil spécifié.

Close()

Ferme les ressources système CompositionObject et libère.

(Hérité de CompositionObject)
ConfigureCenterPointXInertiaModifiers(IIterable<CompositionConditionalValue>)

Prend une liste ordonnée de CompositionConditionalValue. Dans un cadre, tandis que le suivi est en Inertie, le premier CompositionConditionalValue à avoir son ". Condition " évalue la valeur true remplace la valeur centerPointX du zoom que le suivi utilise par son « . Valeur ». Si aucune valeur n’est évaluée à true, CenterPointX n’est pas remplacé par ce cadre.

ConfigureCenterPointYInertiaModifiers(IIterable<CompositionConditionalValue>)

Prend une liste ordonnée de CompositionConditionalValue. Dans un cadre, tandis que le suivi est en Inertie, le premier CompositionConditionalValue à avoir son ". Condition " évalue la valeur true remplace la valeur centerPointY du zoom que le suivi utilise par son « . Valeur ». Si aucune valeur n’est évaluée, CenterPointY n’est pas remplacé par ce cadre.

ConfigurePositionXInertiaModifiers(IIterable<InteractionTrackerInertiaModifier>)

Applique une collection d’objets InteractionTrackerInertiaModifier à l’inertie x d’un InteractionTracker.

La méthode ConfigurePositionXInertiaModifiers applique un individu ou une collection de InteractionTrackerInertiaModifiers au composant x de InteractionTracker. Le système évalue chaque propriété de condition du modificateur X dans l’ordre dans lequel ils ont été ajoutés à InteractionTracker. Ainsi, l’ordre dans lequel le InteractionTrackerInertiaModifier avoir dans la collection sera le même ordre que celui avec lequel le système sera évalué.

ConfigurePositionYInertiaModifiers(IIterable<InteractionTrackerInertiaModifier>)

Applique une collection d’objets InteractionTrackerInertiaModifier à l’inertie y d’un InteractionTracker.

La méthode ConfigurePositionYInertiaModifiers applique un individu ou une collection d'InteractionTrackerInertiaModifiers au composant y de InteractionTracker. Le système évalue chaque propriété de condition du modificateur Y dans l’ordre dans lequel ils ont été ajoutés à InteractionTracker. Ainsi, l’ordre dans lequel le InteractionTrackerInertiaModifier avoir dans la collection sera le même ordre que celui avec lequel le système sera évalué.

ConfigureScaleInertiaModifiers(IIterable<InteractionTrackerInertiaModifier>)

Applique une collection d’objets InteractionTrackerInertiaModifier à l’échelle d’un InteractionTracker.

La méthode ConfigureScaleInertiaModifiers applique un individu ou une collection d'InteractionTrackerInertiaModifierà l’échelle du composant d'InteractionTracker. Le système évalue chaque propriété de condition du modificateur d’échelle dans l’ordre dans lequel ils ont été ajoutés à InteractionTracker. Ainsi, l’ordre dans lequel le InteractionTrackerInertiaModifier avoir dans la collection sera le même ordre que celui avec lequel le système sera évalué.

ConfigureVector2PositionInertiaModifiers(IIterable<InteractionTrackerVector2InertiaModifier>)

Applique une collection d’objets InteractionTrackerInertiaModifier à la position d’un InteractionTracker.

Create(Compositor)

Crée une instance de InteractionTracker.

Cette méthode Create instancie un InteractionTracker. Après avoir créé le InteractionTracker en définissant les propriétés, en attachant un VisualInteractionSource, et en référençant la position ou l’échelle dans un ExpressionAnimation, l’entrée active peut piloter l'ExpressionAnimation .

CreateWithOwner(Compositor, IInteractionTrackerOwner)

Crée une instance de InteractionTracker avec le propriétaire spécifié.

Cette méthode Create instancie un InteractionTracker avec un propriétaire pour s’inscrire aux rappels. Après avoir créé le InteractionTracker en définissant les propriétés, en attachant un VisualInteractionSource, et en référençant la position ou l’échelle dans un ExpressionAnimation, l’entrée active peut piloter l'ExpressionAnimation . La création de l'InteractionTracker avec un propriétaire n’est requise que si l’application doit recevoir des rappels concernant l’état et les valeurs de l'InteractionTracker .

Dispose()

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.

(Hérité de CompositionObject)
GetBindingMode(InteractionTracker, InteractionTracker)

Récupère le mode d’axe de liaison entre deux suivis d’interaction.

PopulatePropertyInfo(String, AnimationPropertyInfo)

Définit une propriété qui peut être animée.

(Hérité de CompositionObject)
SetBindingMode(InteractionTracker, InteractionTracker, InteractionBindingAxisModes)

Définit le mode d’axe de liaison entre deux suivis d’interaction.

StartAnimation(String, CompositionAnimation, AnimationController)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Démarre un groupe d’animations.

La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet.

(Hérité de CompositionObject)
StopAnimation(String)

Déconnecte une animation de la propriété spécifiée et arrête l’animation.

(Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Arrête un groupe d’animations.

(Hérité de CompositionObject)
TryGetAnimationController(String)

Retourne un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée.

(Hérité de CompositionObject)
TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

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

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

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.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Tente d’ajuster la position du InteractionTracker par la quantité spécifiée à l’aide de l’option de pince spécifiée.

TryUpdatePositionBy(Vector3)

Tente d’ajuster la position de l'InteractionTrackerpar la quantité spécifiée.

La méthode TryUpdatePositionBy met à jour l’emplacement actuel de InteractionTracker par le delta Vector3 spécifié en tant que paramètre. Comme pour TryUpdatePosition, TryUpdatePositionBy est utilisé pour 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 Inactive, CustomAnimation ou Inertie. Cela permet de déplacer la position de InteractionTracker par le delta défini et entrer l’état inactif.

TryUpdatePositionWithAdditionalVelocity(Vector3)

Tente de mettre à jour la position deInteractionTracker en ajoutant de la vitesse.

La méthode TryUpdatePositionWithAdditionalVelocity ajoute l’entrée Vector3 représentant une vitesse supplémentaire à la vitesse actuelle de InteractionTracker. Par conséquent, étant donné que la vitesse de interactionTracker a maintenant changé, la position de repos ciblée pour InteractionTracker change maintenant. TryUpdatePositionWithAdditionalVelocity peut être appelé à partir d’états Inactive, Inertie ou CustomAnimation. Cela permet d’ajouter ou de mettre à jour la vitesse de InteractionTracker et d’entrer l’état Inertie.

TryUpdatePositionWithAnimation(CompositionAnimation)

Tente de mettre à jour la position InteractionTrackeren appliquant une animation.

La méthode TryUpdatePositionWithAnimation met à jour la position de InteractionTracker en fonction de l’entrée CompositionAnimation en tant que paramètre. Cette méthode est utilisée dans les situations où le mouvement de InteractionTracker doit être défini par une animation spécifique, au lieu de l’expérience d’inertie traditionnelle. TryUpdatePositionWithAnimation peut être appelé à partir de l’état Inactif ou Inertie. Ainsi, InteractionTracker position sera pilotée par l’animation définie et entrez l’état CustomAnimation.

TryUpdateScale(Single, Vector3)

Tente de mettre à jour l’échelle avec la valeur spécifiée.

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

TryUpdateScaleWithAdditionalVelocity(Single, Vector3)

Tente de mettre à jour l’échelle en ajoutant la vitesse spécifiée.

La méthode TryUpdateScaleWithAdditionalVelocity ajoute la scalaire entrée représentant une vitesse supplémentaire à la vitesse actuelle de InteractionTracker, ainsi que le décalage du point central vers le vector3 entré. Par conséquent, étant donné que la vitesse de interactionTracker a maintenant changé, la position de mise à l’échelle ciblée pour InteractionTracker change maintenant. TryUpdateScaleWithAdditionalVelocity peut être appelé à partir d’états Inactive, Inertie ou CustomAnimation. Cela permet d’ajouter ou de mettre à jour la vitesse d’InteractionTracker et d’entrer l’état Inertie.

TryUpdateScaleWithAnimation(CompositionAnimation, Vector3)

Tente de mettre à jour l’échelle avec l’animation spécifiée.

La méthode TryUpdateScaleWithAnimation met à jour la position d’échelle de InteractionTracker en fonction de la CompositionAnimation entrée en tant que paramètre. Cette méthode est utilisée dans les situations où le mouvement de InteractionTracker doit être défini par une animation spécifique, au lieu de l’expérience d’inertie traditionnelle. TryUpdateScaleWithAnimation peut être appelé à partir de l’état Inactif ou Inertie. Ainsi, InteractionTracker position sera pilotée par l’animation définie et entrez l’état CustomAnimation.

S’applique à

Voir aussi