ColorAnimation 类

定义

命名空间:

Windows.UI.Xaml.Media.Animation

使用指定 Duration 上的线性内插对两个目标值之间的 Color 属性值进行动画处理。

public ref class ColorAnimation sealed : Timeline

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ColorAnimation final : Timeline

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ColorAnimation : Timeline

Public NotInheritable Class ColorAnimation
Inherits Timeline

<ColorAnimation .../>

继承

Object Platform::Object IInspectable DependencyObject Timeline ColorAnimation

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下示例演示如何使用 ColorAnimation 对 StackPanel 的背景色进行动画处理。

<StackPanel x:Name="myStackPanel" Background="Red"
  Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">

      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="myStackPanel" 
        Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
        From="Red" To="Blue" Duration="0:0:4"/>

    </Storyboard>
  </StackPanel.Resources>
</StackPanel>

<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00:2.5" />

                <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame 
                creates a variable transition between values depending on the KeySpline property. In this example,
                the animation starts off slow but toward the end of the time segment, it speeds up exponentially.-->
                <SplineColorKeyFrame Value="Green" KeyTime="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</StackPanel>

// Start the animation when the object loads.
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"

或者，可以显式创建 SolidColorBrush，为其命名，并直接定位其 Color 属性。 下面的示例演示如何创建与上一个动画相同的动画，只不过它使用直接属性目标。

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</StackPanel>

// Start the animation when the object loads.
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

注解

使用 ColorAnimation 对 Color 类型的任何依赖属性的属性值进行动画处理。

Color 的线性内插意味着每个 ARGB 值都被视为一个字节，而内插只是一个数学运算。 如果至少一个 RGB 分量在起始值和结束值中相同或接近相同，则颜色内插效果最佳。

通常需要使用间接属性目标，以便以另一个对象的子属性为目标，该对象是目标上某个属性的值。 这是因为在 UI 元素中显示颜色信息的属性很少实际上是 Color 类型。 大多数类型不是 Brush 类型。 若要在 UI 元素上使用 ColorAnimation，通常以作为子属性值的 SolidColorBrush 的 Color 属性为目标。 “示例”部分中的 XAML 示例中显示了此语法。 有关间接属性目标和其他情节提要动画概念的详细信息，请参阅 情节提要动画 或 属性路径语法。

ColorAnimation 通常至少设置了 一个 From、 By 或 To 属性，但绝不会设置全部三个属性。

• 仅从： 动画从 From 属性指定的值发展到要进行动画处理的属性的基值。
• From 和 To： 动画从 From 属性指定的值前进到 To 属性指定的值。
• 发件人和依据： 动画从 From 属性指定的值发展到 由 From 和 By 属性的总和指定的值。
• 仅限： 动画从动画属性的基值或上一个动画的输出值发展到 To 属性指定的值。
• 仅按： 动画从要进行动画处理的属性的基值或上一个动画的输出值到该值的总和以及 By 属性指定的值。

ColorAnimation 的 From、 By 和 To 属性严格不是 Color。 相反，对于 Color，这些是可以为 Null 的。 这些的默认值为 null，而不是未初始化的结构。 该 null 值是动画系统区分你尚未专门设置值的方式。 Visual C++ 组件扩展 (C++/CX) 不具有 Nullable 类型，因此它转而使用 IReference。

构造函数

ColorAnimation()

初始化 ColorAnimation 类的新实例。

属性

AutoReverse	获取或设置一个值，该值指示时间线在完成向前迭代后是否按相反的顺序播放。 (继承自 Timeline)
BeginTime	获取或设置此 时间线 应开始的时间。 (继承自 Timeline)
By	获取或设置动画更改其起始值所依据的总数。
ByProperty	标识 By 依赖属性。
Dispatcher	获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Duration	获取或设置此时间线播放的时间长度，而不是计数重复。 (继承自 Timeline)
EasingFunction	获取或设置应用于此动画的缓动函数。
EasingFunctionProperty	标识 EasingFunction 依赖属性。
EnableDependentAnimation	获取或设置一个值，该值声明是否应允许被视为依赖动画的动画属性使用此动画声明。
EnableDependentAnimationProperty	标识 EnableDependentAnimation 依赖属性。
FillBehavior	获取或设置一个值，该值指定动画在其活动周期结束时的行为方式。 (继承自 Timeline)
From	获取或设置动画的起始值。
FromProperty	标识 From 依赖属性。
RepeatBehavior	获取或设置此时间线的重复行为。 (继承自 Timeline)
SpeedRatio	获取或设置相对于其父级的速率，此时此 时间线的进度。 (继承自 Timeline)
To	获取或设置动画的结束值。
ToProperty	标识 To 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

事件

Completed

在 Storyboard 对象完成播放时发生。 (继承自 Timeline)

另请参阅

• Timeline
• SolidColorBrush
• LinearGradientBrush
• Color
• Colors
• 情节提要动画
• XAML 动画示例