计时行为概述

项目
08/18/2008

更新：2007 年 11 月

本主题描述动画和其他 Timeline 对象的计时行为。

先决条件

若要了解本主题，您应当熟悉基本动画功能。有关更多信息，请参见动画概述。

时间线类型

Timeline 表示一个时间段。它提供的属性可以让您指定该时间段的长度、开始时间、重复次数、该时间段内时间进度的快慢等等。

从时间线类继承的类提供其他诸如动画和媒体播放的功能。WPF 提供以下 Timeline 类型。

时间线类型	说明
AnimationTimeline	Timeline 对象（这些对象生成输出值以对属性进行动画处理）的抽象基类。
MediaTimeline	从媒体文件生成输出。
ParallelTimeline	一种 TimelineGroup，对子 Timeline 对象进行分组和控制。
Storyboard	一种 ParallelTimeline，为其包含的 Timeline 对象提供目标信息。
Timeline	定义计时行为的抽象基类。
TimelineGroup	可包含其他 Timeline 对象的 Timeline 对象的抽象类。

用于控制时间线长度的属性

Timeline 表示一个时间段，时间线的长度可以用不同的方法描述。下表定义了几个用于描述时间线长度的术语。

术语	说明	属性
简单持续时间	时间线向前迭代一次所花费的时间长度。	Duration
一次重复	时间线向前播放一次所花费的时间长度，如果 AutoReverse 属性为 True，则是倒退一次的时间长度。	Duration, AutoReverse
活动期	时间线完成所有由其 RepeatBehavior 属性指定的重复所花费的时间长度。	Duration, AutoReverse, RepeatBehavior

Duration 属性

如前文所述，时间线代表一个时间段。该时间段的长度由时间线的 Duration 属性确定。当时间线达到其持续时间的终点时，就会停止播放。如果该时间线具有子时间线，那么这些子时间线也会停止播放。当播放的是动画时，Duration 属性指定了动画从其起始值转换为结束值所花费的时间。时间线的持续时间有时称为“简单持续时间”以区分一次迭代的持续时间和动画播放（包括重复）的总时间长度。您可以使用有限时间值或特殊值（Automatic 或 Forever）指定持续时间。动画的持续时间应该解析为 TimeSpan 值，这样它就可以在值之间转换。

下面的示例演示了其 Duration 属性为 5 秒的 DoubleAnimation。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5"  />

容器时间线（例如 Storyboard 和 ParallelTimeline）的默认持续时间为 Automatic，这意味着当其最后的子时间线停止播放后，它们将自动结束。下面的示例演示了一个 Storyboard，其 Duration 解析为 5 秒，这 5 秒是所有其子 DoubleAnimation 对象完成所花费的时间长度。

<Storyboard >

  <DoubleAnimation 
    Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:5"  />

  <DoubleAnimation 
    Storyboard.TargetName="MyOtherRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:3"  />

</Storyboard>

通过将容器时间线的 Duration 设置为 TimeSpan 值，您可以强行使其播放的时间与其子 Timeline 对象播放的时间不同。如果将 Duration 设置为一个小于容器时间线的子 Timeline 对象长度的值，那么当容器时间线停止播放时，子 Timeline 对象也会停止播放。下面的示例将 Storyboard 的 Duration 从前面示例中的值设置为 3 秒。结果，第一个 DoubleAnimation 将目标矩形宽度动画处理为 60 后，播放了 3 秒就停止播放。

<Storyboard Duration="0:0:3">

  <DoubleAnimation 
    Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:5"  />

  <DoubleAnimation 
    Storyboard.TargetName="MyOtherRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:3"  />

</Storyboard>

RepeatBehavior 属性

Timeline 控件的 RepeatBehavior 属性控制它重复其简单持续时间的次数。使用 RepeatBehavior 属性，您可以指定时间线播放的次数（一次迭代 Count）或它将播放的总时间长度（一次重复 Duration）。无论是哪一种情况，动画都将从头到尾地不断运行许多次，直到完成要求的次数或经历完所需的一段时间。默认情况下，时间线的迭代次数为 1.0，即播放一次时间线，根本不进行重复。

下面的示例使用 RepeatBehavior 属性指定一个迭代次数来将 DoubleAnimation 播放时间延长为简单持续时间的两倍。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5" 
  RepeatBehavior="2x" />

接下来的示例使用 RepeatBehavior 属性将 DoubleAnimation 播放时间缩减为简单持续时间的一半。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5" 
  RepeatBehavior="0.5x" />

如果将 Timeline 的 RepeatBehavior 属性设置为 Forever，则 Timeline 将会一直重复，直到手动停止或由计时系统停止。下面的示例使用 RepeatBehavior 属性使 DoubleAnimation 无限次播放。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5" 
  RepeatBehavior="Forever" />

有关其他示例，请参见如何：重复动画。

AutoReverse 属性

AutoReverse 属性指定 Timeline 在每次向前迭代结束后是否倒退。下面的示例将 DoubleAnimation 的 AutoReverse 属性设置为 true，结果，它从 0 到 100 播放动画，然后又从 100 到 0 播放动画。总共播放了 10 秒。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5" 
  AutoReverse="True" />

当您使用 Count 值指定 Timeline 的 RepeatBehavior，并且 Timeline 的 AutoReverse 属性为 true 时，一次重复包含一次向前迭代和一次向后迭代。下面的示例将 DoubleAnimation 的 RepeatBehavior 从以前示例中的值设置成 Count 为 2。结果，DoubleAnimation 播放了 20 秒：向前 5 秒，向后 5 秒，再向前 5 秒，然后再向后 5 秒。

<DoubleAnimation 
  Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
  From="0" To="100" Duration="0:0:5" 
  RepeatBehavior="2" 
  AutoReverse="True" />

如果容器时间线有子 Timeline 对象，当容器时间线反向时，它们也会反向。有关更多示例，请参见如何：指定时间线是否自动反转。

BeginTime 属性

BeginTime 属性可以让您指定时间线开始的时间。时间线的开始时间相对于其父时间线。如果开始时间为 0 秒，则意味着其父时间线开始后，该时间线立即开始；如果设置为其他值，则会在父时间线和子时间线的开始播放时间之间产生一个时间差。例如，如果开始时间设置为 2 秒，意味着当其父时间线播放 2 秒后，该子时间线才开始播放。默认情况下，所有时间线的开始时间都为 0 秒。您也可以将时间线的开始时间设置为 null，这会阻止时间线开始播放。在 WPF 中，您可以使用 x:Null 标记扩展指定 Null。

请注意，每次时间线重复时，因为其 RepeatBehavior 设置，不会应用开始时间。如果您要创建的动画的 BeginTime 为 10 秒并且其 RepeatBehavior 为 Forever，则在动画第一次播放前，将会延迟 10 秒，但是后面的每次重复不会这样。但是，如果动画的父时间线重新开始或重复，则会延迟 10 秒。

BeginTime 属性用于错开时间线。下面的示例创建一个包含两个子 DoubleAnimation 对象的 Storyboard。第一个动画的 Duration 为 5 秒，第二个动画的 Duration 为 3 秒。该示例将第二个 DoubleAnimation 的 BeginTime 设置为 5 秒，这样它在第一个 DoubleAnimation 结束后就会开始播放。

<Storyboard>

  <DoubleAnimation 
    Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:5" 
    BeginTime="0:0:0" />


  <DoubleAnimation 
    Storyboard.TargetName="MyOtherRectangle" Storyboard.TargetProperty="Width"
    From="0" To="100" Duration="0:0:3"  
    BeginTime="0:0:5" />

</Storyboard>

FillBehavior 属性

当 Timeline 达到其总活动期的结尾时，FillBehavior 属性指定它是停止还是保持其最后的值。如果动画的 FillBehavior 为 HoldEnd，则“保持”其输出值：进行动画处理的属性保留动画的最后值。Stop 值会导致动画在结束后停止影响其目标属性。

下面的示例创建一个包含两个子 DoubleAnimation 对象的 Storyboard。两个 DoubleAnimation 对象都将 Rectangle 的 Width 从 0 动画处理为 100。Rectangle 元素的未进行动画处理的 Width 值为 500 个与设备无关的像素。

第一个 DoubleAnimation 的 FillBehavior 属性设置为默认值 HoldEnd。结果，矩形的宽度在 DoubleAnimation 结束后保持为 100。
第二个 DoubleAnimation 的 FillBehavior 属性设置为 Stop。结果，第二个 Rectangle 的 Width 在 DoubleAnimation 结束后还原为 500。

<Rectangle Name="MyRectangle" 
 Width="500" Height="100"
 Opacity="1" Fill="Red">
</Rectangle>

<Rectangle Name="MyOtherRectangle" 
 Width="500" Height="100"
 Opacity="1" Fill="Orange">
</Rectangle>

<Button Content="Start FillBehavior Example">
  <Button.Triggers>
    <EventTrigger RoutedEvent="Button.Click">
      <BeginStoryboard>
        <Storyboard>
          <DoubleAnimation 
            Storyboard.TargetName="MyRectangle" Storyboard.TargetProperty="Width"
            From="0" To="100" Duration="0:0:5" 
            FillBehavior="HoldEnd" />
          <DoubleAnimation 
            Storyboard.TargetName="MyOtherRectangle" Storyboard.TargetProperty="Width"
            From="0" To="100" Duration="0:0:5"  
            FillBehavior="Stop" />
        </Storyboard>
      </BeginStoryboard>
    </EventTrigger>
  </Button.Triggers>
</Button>

用于控制时间线速度的属性

Timeline 类提供三个用于指定其速度的属性：

SpeedRatio - 指定 Timeline 相对于其父时间线的时间进度速率。大于 1 的值增加 Timeline 及其子 Timeline 对象的速率，0 和 1 之间的值减慢其速率。值 1 表明 Timeline 的进度速率与其父时间线相同。容器时间线的 SpeedRatio 设置也会影响其所有子 Timeline 对象。
AccelerationRatio - 指定时间线花费在加速上的 Duration 百分比。有关示例，请参见如何：使动画加速或减速。
DecelerationRatio - 指定时间线花费在减速上的 Duration 百分比。有关示例，请参见如何：使动画加速或减速。

请参见

通过