Microsoft.UI.Composition.Interactions 命名空间

提供在视觉层中启用输入驱动动画的功能。

名称 说明
CompositionConditionalValue

允许条件修改视觉交互源的位置和规模。

CompositionInteractionSourceCollection

交互源的集合。

这是与给定 InteractionTracker 关联的交互源的集合。 此集合的唯一有效成员是 VisualInteractionSource。 每个 VisualInteractionSource 都需要具有唯一的命中测试(源)视觉对象。 将单独配置每个 VisualInteractionSource ,以便将所需的输入发送到 InteractionTracker

InteractionSourceConfiguration

表示 VisualInteractionSource 输入的配置。

InteractionTracker

处理可在 ExpressionAnimations 中用作目标的输入逻辑,通常基于输入驱动视觉对象的运动。

InteractionTrackerCustomAnimationStateEnteredArgs

IInteractionTrackerOwner.CustomAnimationStateEntered 回调的参数。

InteractionTrackerIdleStateEnteredArgs

IInteractionTrackerOwner.IdleStateEntered 回调的参数。

InteractionTrackerInertiaModifier

惯性修饰符的基类。

InteractionTrackerInertiaModifier 表示惯性修饰符的基类。 惯性修饰符可以被视为改变 InteractionTracker 到达其最终休息位置的位置和方式的行为的方法。 当需要更多自定义运动体验(如对齐点)时,通常使用 InteractionTracker 的此行为。 可以使用惯性修饰符修改 InteractionTracker 的行为有两种变化:在与 InteractionTrackerInertiaRestingValue 类交互后修改其最终休息位置,或定义用于在惯性与 InteractionTrackerInertiaMotion 类中计算实际运动和最终休息位置的公式。 这些修饰符应用于 InteractionTracker 的 X 位置、Y 位置或刻度。

InteractionTrackerInertiaMotion

一个 ExpressionAnimation ,用于定义 InteractionTracker 在其惯性状态期间的运动。

InteractionTrackerMotion 类包含两个 ExpressionAnimation,表示位置 InteractionTracker 的第二个派生公式,用于在满足特定条件时定义从惯性开始到尾的动作。 InteractionTrackerMotion 类定义为两部分:用于定义动作何时进行的条件语句,以及描述 InteractionTracker 如何到达其最终休息位置的动作的公式。 需要定义自定义运动(如 spring 运动)时,利用 InteractionTrackerInertiaMotion 类,以便在 交互Tracker 处于惯性状态时使用。

InteractionTrackerInertiaNaturalMotion

ScalarNaturalMotionAnimation,定义 InteractionTracker 在其惯性状态期间的运动。

InteractionTrackerInertiaRestingValue

一个 ExpressionAnimation ,用于定义交互后的其余位置。

InteractionTrackerInertiaRestingValue 类定义两个 ExpressionAnimation,用于在满足特定条件时计算 InteractionTracker 的显式休息位置。 InteractionTrackerInertiaRestingValue 定义为两部分:如果为 true,则需显式定义 InteractionTracker 的特定休息位置的条件语句,以及描述输出位置的数学关系的公式。 需要确保 InteractionTracker 在交互发生后降落在特定位置时,利用 InteractionTrackerInertiaRestingValue 类。

InteractionTrackerInertiaStateEnteredArgs

IInteractionTrackerOwner.InertiaStateEntered 回调的参数。

InteractionTrackerOwner.InertiaStateEntered 类定义 InteractionTracker 进入惯性状态时可访问的和 up-to-date 属性值。 如果注册 了 InertiaStateEntered 事件,则此对象的属性的值表示系统在惯性状态开始时计算的结果。 使用修改的和自然的休息位置有助于实现滚动虚拟化等方案。

InteractionTrackerInteractingStateEnteredArgs

IInteractionTrackerOwner.InteractingStateEntered 回调的参数。

InteractionTrackerRequestIgnoredArgs

IInteractionTrackerOwner.RequestIgnored 回调的参数。

InteractionTrackerValuesChangedArgs

IInteractionTrackerOwner.ValuesChanged 回调的参数。

InteractionTrackerVector2InertiaModifier

InteractionTrackerVector2InertiaNaturalMotion 的基类。

InteractionTrackerVector2InertiaNaturalMotion

Vector2NaturalMotionAnimation,定义 InteractionTracker 在其惯性状态期间的运动。

VisualInteractionSource

用于配置与视觉对象相对的 InteractionTracker 的输入的对象。

VisualInteractionSource 仅用于 InteractionTracker ,并定义将发送到 InteractionTracker 的输入以驱动其状态和属性。 此类包含用于命中测试的视觉对象,以及各种配置属性,其中手势和输入类型将发送到 InteractionTracker

接口

名称 说明
ICompositionInteractionSource

正在跟踪合成器中交互的对象。

IInteractionTrackerOwner

包含将由 InteractionTracker 事件触发的回调。

实现此接口可以接收有关 InteractionTracker 的状态和值的回调,以及是否遵循 对 InteractionTracker 属性的请求更新。

枚举

名称 说明
InteractionBindingAxisModes

定义常量,该常量指定两个交互跟踪器之间的轴绑定。

InteractionChainingMode

定义 VisualInteractionSource 的链接行为。 有三个选项:始终链、永不链或自动链(让系统选择)。 如果启用了链接,则 当 InteractionTracker 达到其最小或最大边界时,它将改为将输入发送到下一个上级 VisualInteractionSource

InteractionSourceMode

提供 VisualInteractionSource 如何处理交互的各种定义。 可用于枚举的选项为 DisabledEnabledWithInertiaEnabledWithoutInertia。 InteractionSourceMode 可用于定义 VisualInteractionSource 的 X、Y 和刻度轴的行为。

InteractionSourceRedirectionMode

定义指定是否应将输入重定向到 InteractionTracker 的常量。

InteractionTrackerClampingOption

定义常量,指定在更新 InteractionTracker 位置时如何固定值。

InteractionTrackerPositionUpdateOption

定义常量,该常量指示是否应允许已运行的自定义缩放动画继续运行。

VisualInteractionSourceRedirectionMode

指示应重定向到 InteractionTracker 的输入。