Microsoft.UI.Composition.Interactions Namespace

Stellt Funktionen bereit, die eingabegesteuerte Animationen in der visuellen Ebene ermöglichen.

Klassen

Name Beschreibung
CompositionConditionalValue

Ermöglicht die bedingte Änderung der Position und skalierung einer visuellen Interaktionsquelle.

CompositionInteractionSourceCollection

Eine Sammlung von Interaktionsquellen.

Dies ist die Sammlung von Interaktionsquellen, die einem bestimmten InteractionTracker zugeordnet sind. Das einzige gültige Element dieser Auflistung ist eine VisualInteractionSource. Jede VisualInteractionSource muss über einen eindeutigen Treffertest (Quelle) verfügen. Jede VisualInteractionSource wird einzeln für die gewünschte Eingabe konfiguriert, die an den InteractionTracker gesendet werden soll.

InteractionSourceConfiguration

Stellt die Konfiguration einer VisualInteractionSource-Eingabe dar.

InteractionTracker

Behandelt die Logik der Eingabe, die als Ziele in ExpressionAnimations verwendet werden kann – in der Regel, um die Bewegung visueller Elemente basierend auf der Eingabe zu steuern.

InteractionTrackerCustomAnimationStateEnteredArgs

Argumente für den Rückruf von IInteractionTrackerOwner.CustomAnimationStateEntered .

InteractionTrackerIdleStateEnteredArgs

Argumente für den Rückruf von IInteractionTrackerOwner.IdleStateEntered .

InteractionTrackerInertiaModifier

Basisklasse für Inertia-Modifizierer.

Der InteractionTrackerInertiaModifier stellt die Basisklasse für Inertia-Modifizierer dar. Inertia-Modifizierer können sich als Möglichkeiten zum Ändern des Verhaltens für den Ort und die Art und Weise angesehen werden, wie InteractionTracker seine endgültige Ruheposition erreicht. Das Ändern dieses Verhaltens von InteractionTracker wird häufig verwendet, wenn mehr benutzerdefinierte Bewegungsoberflächen erforderlich sind, z. B. Andockpunkte. Es gibt zwei Variationen, mit denen Sie das Verhalten von InteractionTracker mithilfe von Inertia-Modifizierern ändern können: Ändern der endgültigen Ruheposition nach Der Interaktion mit der InteractionTrackerInertiaRestingValue-Klasse oder definieren Sie die Formel, die zum Berechnen der tatsächlichen Bewegung und der endgültigen Ruheposition während der Inertia mit der InteractionTrackerInertiaMotion-Klasse verwendet wird. Diese Modifizierer werden entweder auf X-Position, Y-Position oder Skalierung von InteractionTracker angewendet.

InteractionTrackerInertiaMotion

Eine ExpressionAnimation , die die Bewegung von InteractionTracker während des Inertia-Zustands definiert.

Die InteractionTrackerMotion-Klasse enthält zwei ExpressionAnimation-Elemente, die eine zweite abgeleitete Formel der Position InteractionTracker darstellen, um die Bewegung vom Anfang bis zum Ende der Inertiierung zu definieren, wenn eine bestimmte Bedingung erfüllt ist. Die InteractionTrackerMotion-Klasse ist als zwei Teile definiert: Die bedingte Anweisung, die definiert, wann die Bewegung stattfindet, und die Formel, die die Bewegung beschreibt, wie InteractionTracker seine endgültige Ruheposition erreicht. Verwenden Sie die InteractionTrackerInertiaMotion-Klasse, wenn Sie eine angepasste Bewegung (z. B. eine Federbewegung) für InteractionTracker definieren müssen, die beim Inertia-Zustand verwendet werden soll.

InteractionTrackerInertiaNaturalMotion

Eine ScalarNaturalMotionAnimation , die bewegung von InteractionTracker während des Inertia-Zustands definiert.

InteractionTrackerInertiaRestingValue

Eine ExpressionAnimation , die die Restposition nach einer Interaktion definiert.

Die InteractionTrackerInertiaRestingValue-Klasse definiert zwei ExpressionAnimation-Werte, die eine explizite Ruheposition für InteractionTracker berechnen, wenn eine bestimmte Bedingung erfüllt ist. Der InteractionTrackerInertiaRestingValue ist als zwei Teile definiert: Die bedingte Anweisung, in der der spezifische Restspeicherort von InteractionTracker explizit definiert werden muss, wenn "true" und die Formel, die eine mathematische Beziehung beschreibt, die den Speicherort ausgibt. Verwenden Sie die InteractionTrackerInertiaRestingValue-Klasse, wenn Sie sicherstellen müssen, dass InteractionTracker an einem bestimmten Ort landet, nachdem eine Interaktion erfolgt.

InteractionTrackerInertiaStateEnteredArgs

Argumente für den Rückruf von IInteractionTrackerOwner.InertiaStateEntered .

Die InteractionTrackerOwner.InertiaStateEntered-Klasse definiert die Werte der barrierefreien und up-to-date-Eigenschaft, wenn InteractionTracker in den Inertia-Zustand wechselt. Wenn sie für das InertiaStateEntered-Ereignis registriert ist, stellen Die Werte der Eigenschaften dieses Objekts die Vom System am Anfang des Trägheitszustands berechneten Ergebnisse dar. Die Verwendung der geänderten und natürlichen Ruhepositionen ermöglicht Szenarien wie Scrollen der Virtualisierung.

InteractionTrackerInteractingStateEnteredArgs

Argumente für den Rückruf von IInteractionTrackerOwner.InteractingStateEntered .

InteractionTrackerRequestIgnoredArgs

Argumente für den IInteractionTrackerOwner.RequestIgnored-Rückruf .

InteractionTrackerValuesChangedArgs

Argumente für den IInteractionTrackerOwner.ValuesChanged-Rückruf .

InteractionTrackerVector2InertiaModifier

Basisklasse für InteractionTrackerVector2InertiaNaturalMotion.

InteractionTrackerVector2InertiaNaturalMotion

A Vector2NaturalMotionAnimation that defines motion of InteractionTracker during its inertia state.

VisualInteractionSource

Objekt zum Konfigurieren von Eingaben für interactionTracker relativ zu einem visuellen Element.

Die VisualInteractionSource wurde nur für InteractionTracker verwendet und definiert, welche Eingabe an den InteractionTracker gesendet wird, um den Zustand und die Eigenschaften zu steuern. Diese Klasse enthält sowohl das visuelle Element, das für Treffertests verwendet werden soll, als auch eine Vielzahl von Konfigurationseigenschaften, für die Gesten und Eingabetypen an den InteractionTracker gesendet werden.

Schnittstellen

Name Beschreibung
ICompositionInteractionSource

Ein Objekt, das für Interaktionen im Kompositor nachverfolgt wird.

IInteractionTrackerOwner

Enthält Rückrufe, die von InteractionTracker-Ereignissen ausgelöst werden.

Die Implementierung dieser Schnittstelle ermöglicht das Empfangen von Rückrufen bezüglich des Zustands und der Werte des InteractionTracker sowie die Frage, ob angeforderte Aktualisierungen der InteractionTracker-Eigenschaften berücksichtigt werden.

Enumerationen

Name Beschreibung
InteractionBindingAxisModes

Definiert Konstanten, die angeben, welche Achse zwischen zwei Interaktions-Trackern gebunden ist.

InteractionChainingMode

Definiert das Verkettungsverhalten für eine VisualInteractionSource. Es gibt drei Optionen: Always chain, never chain or auto chain (let the system choose). Wenn die Verkettung aktiviert ist, sendet ein InteractionTracker stattdessen die Eingabe an die nächste übergeordnete VisualInteractionSource, wenn ein InteractionTracker seine Mindest- oder Höchstgrenzen erreicht.

InteractionSourceMode

Stellt die verschiedenen Definitionen bereit, wie eine VisualInteractionSource Interaktionen verarbeitet. Für die Enumeration verfügbare Optionen sind "Disabled", "EnabledWithInertia" und "EnabledWithoutInertia". Der InteractionSourceMode kann verwendet werden, um das Verhalten für die X-, Y- und Skalierungsachse einer VisualInteractionSource zu definieren.

InteractionSourceRedirectionMode

Definiert Konstanten, die angeben, ob eine Eingabe an den InteractionTracker umgeleitet werden soll.

InteractionTrackerClampingOption

Definiert Konstanten, die angeben, wie Werte beim Aktualisieren der InteractionTracker-Position eingeklemmt werden.

InteractionTrackerPositionUpdateOption

Definiert Konstanten, die angeben, ob eine bereits ausgeführte benutzerdefinierte Skalierungsanimation weiterhin ausgeführt werden darf.

VisualInteractionSourceRedirectionMode

Gibt an, welche Eingabe an den InteractionTracker umgeleitet werden soll.