Microsoft.UI.Composition.Interactions Espace de noms

Fournit des fonctionnalités qui activent les animations pilotées par les entrées dans la couche visuelle.

Classes

Nom Description
CompositionConditionalValue

Autorise la modification conditionnelle de la position et de l’échelle d’une source d’interaction visuelle.

CompositionInteractionSourceCollection

Collection de sources d’interaction.

Il s’agit de la collection de sources d’interaction associées à un InteractionTracker donné. Le seul membre valide de cette collection est visualInteractionSource. Chaque VisualInteractionSource doit avoir un visuel de test de positionnement (source) unique. Chaque VisualInteractionSource sera configuré individuellement pour l’entrée souhaitée à envoyer à InteractionTracker.

InteractionSourceConfiguration

Représente la configuration d’une entrée VisualInteractionSource.

InteractionTracker

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.

InteractionTrackerCustomAnimationStateEnteredArgs

Arguments du rappel IInteractionTrackerOwner.CustomAnimationStateEntered .

InteractionTrackerIdleStateEnteredArgs

Arguments pour le rappel IInteractionTrackerOwner.IdleStateEntered .

InteractionTrackerInertiaModifier

Classe de base pour les modificateurs d’inertie.

InteractionTrackerInertiaModifier représente la classe de base pour les modificateurs d’inertie. Les modificateurs d’inertie peuvent être considérés comme des façons de modifier le comportement pour où et comment InteractionTracker atteint sa position de repos finale. La modification de ce comportement d’InteractionTracker est couramment utilisée lorsque des expériences de mouvement plus personnalisées sont nécessaires, telles que les points d’ancrage. Il existe deux variantes de la façon dont vous pouvez modifier le comportement d’InteractionTracker à l’aide de modificateurs d’inertie : modifier sa position de repos finale après l’interaction avec la classe InteractionTrackerInertiaRestingValue ou définir l’équation utilisée pour calculer le mouvement réel et la position de repos finale pendant l’inertie avec la classe InteractionTrackerInertiaMotion . Ces modificateurs sont appliqués à X Position, Y Position ou Scale of InteractionTracker.

InteractionTrackerInertiaMotion

ExpressionAnimation qui définit le mouvement d’InteractionTracker pendant son état d’inertie.

La classe InteractionTrackerMotion contient deux expressions ExpressionAnimationreprésentant une deuxième équation dérivée de position InteractionTracker sera utilisée pour définir le mouvement du début à la fin de l’inertie lorsqu’une condition particulière est remplie. La classe InteractionTrackerMotion est définie en deux parties : l’instruction conditionnelle à définir quand le mouvement aura lieu et l’équation qui décrit le mouvement pour la façon dont InteractionTracker atteint sa position de repos finale. Utilisez la classe InteractionTrackerInertiaMotion lorsque vous devez définir un mouvement personnalisé (par exemple, un mouvement de printemps) pour InteractionTracker à utiliser lorsqu’il est dans son état d’inertie.

InteractionTrackerInertiaNaturalMotion

ScalarNaturalMotionAnimation qui définit le mouvement d’InteractionTracker pendant son état d’inertie.

InteractionTrackerInertiaRestingValue

ExpressionAnimation qui définit la position de repos après une interaction.

La classe InteractionTrackerInertiaRestingValue définit deux expressions ExpressionAnimationqui calculent une position de repos explicite pour InteractionTracker lorsqu’une condition particulière est remplie. InteractionTrackerInertiaRestingValue est défini en deux parties : l’instruction conditionnelle dans laquelle l’emplacement de repos spécifique d’InteractionTracker doit être explicitement défini si true et l’équation qui décrit une relation mathématique qui génère l’emplacement. Utilisez la classe InteractionTrackerInertiaRestingValue quand vous devez vous assurer que InteractionTracker atterrit sur un emplacement spécifique après une interaction.

InteractionTrackerInertiaStateEnteredArgs

Arguments du rappel IInteractionTrackerOwner.InertiaStateEntered .

La classe InteractionTrackerOwner.InertiaStateEntered définit les valeurs de propriété accessible et up-to-date lorsque InteractionTracker entre dans l’état d’inertie. Si elles sont inscrites pour l’événement InertieStateEntered , les valeurs des propriétés de cet objet représentent les résultats calculés par le système au début de l’état d’inertie. L’utilisation des positions de repos modifiées et naturelles permet d’activer des scénarios tels que la virtualisation de défilement.

InteractionTrackerInteractingStateEnteredArgs

Arguments du rappel IInteractionTrackerOwner.InteractingStateEntered .

InteractionTrackerRequestIgnoredArgs

Arguments pour le rappel IInteractionTrackerOwner.RequestIgnored .

InteractionTrackerValuesChangedArgs

Arguments pour le rappel IInteractionTrackerOwner.ValuesChanged .

InteractionTrackerVector2InertiaModifier

Classe de base pour InteractionTrackerVector2InertiaNaturalMotion.

InteractionTrackerVector2InertiaNaturalMotion

Vector2NaturalMotionAnimation qui définit le mouvement d’InteractionTracker pendant son état d’inertie.

VisualInteractionSource

Objet de configuration de l’entrée dans InteractionTracker par rapport à un visuel.

VisualInteractionSource est conçu pour être utilisé uniquement avec InteractionTracker et définit l’entrée qui sera envoyée à InteractionTracker pour piloter son état et ses propriétés. Cette classe contient à la fois le visuel à utiliser pour les tests de positionnement, ainsi que diverses propriétés de configuration pour lesquelles les mouvements et les types d’entrée seront envoyés à InteractionTracker.

Interfaces

Nom Description
ICompositionInteractionSource

Objet qui est suivi pour les interactions dans le compositeur.

IInteractionTrackerOwner

Contient des rappels qui seront déclenchés par les événements InteractionTracker.

L’implémentation de cette interface permet de recevoir des rappels concernant l’état et les valeurs de l’InteractionTracker, ainsi que si les mises à jour demandées des propriétés d’InteractionTracker sont respectées.

Énumérations

Nom Description
InteractionBindingAxisModes

Définit des constantes qui spécifient l’axe lié entre deux suivis d’interaction.

InteractionChainingMode

Définit le comportement de chaînage d’un VisualInteractionSource. Il existe trois options : Toujours chaîne, jamais chaîne ou chaîne automatique (laissez le système choisir). Si le chaînage est activé, lorsqu’un InteractionTracker atteint ses limites minimales ou maximales, il envoie plutôt l’entrée au prochain ancêtre VisualInteractionSource.

InteractionSourceMode

Fournit les différentes définitions permettant de traiter les interactions d’un VisualInteractionSource . Les options disponibles pour l’énumération sont Disabled, EnabledWithInertia et EnabledWithoutInertia. InteractionSourceMode peut être utilisé pour définir le comportement de l’axe X, Y et Scale d’un VisualInteractionSource.

InteractionSourceRedirectionMode

Définit des constantes qui spécifient si une entrée doit être redirigée vers InteractionTracker.

InteractionTrackerClampingOption

Définit des constantes qui spécifient la façon dont les valeurs sont limitées lorsque la position InteractionTracker est mise à jour.

InteractionTrackerPositionUpdateOption

Définit des constantes qui indiquent si une animation de mise à l’échelle personnalisée déjà en cours d’exécution doit être autorisée à continuer à s’exécuter.

VisualInteractionSourceRedirectionMode

Indique quelle entrée doit être redirigée vers InteractionTracker.