StepEasingFunction 类

定义

命名空间:

Windows.UI.Composition

一个步骤函数，用于在动画关键帧之间内插，该函数以增量推进动画，例如可以定义的步骤。 可以自定义初始和最终步骤的行为。

public ref class StepEasingFunction sealed : CompositionEasingFunction

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StepEasingFunction final : CompositionEasingFunction

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StepEasingFunction : CompositionEasingFunction

Public NotInheritable Class StepEasingFunction
Inherits CompositionEasingFunction

继承

Object Platform::Object IInspectable CompositionObject CompositionEasingFunction StepEasingFunction

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

示例

class StepsEasing
{
  StepsEasing(Compositor compositor, SpriteVisual heroVisual)
  {
    // This step function makes the property offset change in 5 steps
    // i.e. goes from (0,0,0) à (20,20,20) in 5 steps.
    StepEasingFunction steps = compositor.CreateStepEasingFunction(5);

    Vector3KeyFrameAnimation animation = compositor.CreateVector3KeyFrameAnimation();
    animation.InsertKeyFrame(0f, new Vector3(0f,0f,0f));
    animation.InsertKeyFrame(1f, new Vector3(20f,20f,0f), steps);
    animation.Duration = TimeSpan.FromSeconds(2);

    heroVisual.StartAnimation("Offset", animation);
  }
}

注解

步进缓动函数为动画的增量前进提供了更大的灵活性。 增量是使用 StepCount 属性定义的。 可以使用 InitialStep 和 FinalStep 自定义步骤。 可以使用 IsInitialStepSingleFrame 自定义初始步骤的行为，使用 IsFinalStepSingleFrame 自定义最后一步的行为。

若要创建 的新 StepEasingFunction实例，请调用以下方法之一：

• CompositionEasingFunction.CreateStepEasingFunction (所有者 stepCount)
• CompositionEasingFunction.CreateStepEasingFunction (所有者)
• Compositor.CreateStepEasingFunction (stepCount)
• Compositor.CreateStepEasingFunction ()

属性

Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject)
Dispatcher	CompositionObject 的调度程序。 (继承自 CompositionObject)
DispatcherQueue	获取 CompostionObject 的 DispatcherQueue 。 (继承自 CompositionObject)
FinalStep	要结束的步骤。
ImplicitAnimations	附加到此 对象的隐式动画的集合。 (继承自 CompositionObject)
InitialStep	要开始的步骤。
IsFinalStepSingleFrame	指示最后一步是否应持续尽可能短的持续时间。
IsInitialStepSingleFrame	指示初始步骤是否应持续尽可能短的持续时间。
Properties	与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject)
StepCount	起始值和结束值之间的步骤数。

方法

Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	连接和动画。 (继承自 CompositionObject)
DisconnectAnimation(String)	断开动画的连接。 (继承自 CompositionObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。 (继承自 CompositionObject)
StopAnimation(String)	断开动画与指定属性的连接，并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)

另请参阅

• CompositionEasingFunction
• IClosable
• 合成动画概述