ColorAnimation.By 属性

定义

命名空间:

Microsoft.UI.Xaml.Media.Animation

获取或设置动画更改其起始值所依据的总数。

public:
 property IReference<Color> ^ By { IReference<Color> ^ get(); void set(IReference<Color> ^ value); };

IReference<Color> By();

void By(IReference<Color> value);

public System.Nullable<Color> By { get; set; }

var iReference = colorAnimation.by;
colorAnimation.by = iReference;

Public Property By As Nullable(Of Color)

<ColorAnimation By="colorString"/>
-or-
<ColorAnimation By="referenceToColor"/>
- or -
<ColorAnimation>
  <ColorAnimation.By>
    <Color>colorString</Color>
  </ColorAnimation.By>
</ColorAnimation>

属性值

IReference<Color>

Nullable<Color>

动画更改其起始值所依据的总数。 默认值为 NULL。

如果使用 C# 或 Visual Basic 进行编程，则此属性的类型投影为 Color？ (可以为 null 的 Color) 。

示例

<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">
            <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
                            Storyboard.TargetProperty="Color" Duration="0:0:4" 
                            By="#0000FF"/>
        </Storyboard>
    </StackPanel.Resources>

    <StackPanel Orientation="Horizontal">
        <Button Content="Animate color" Click="Start_Animation"/>
        <Rectangle Height="100" Width="300" Margin="12,0">
            <Rectangle.Fill>
                <SolidColorBrush x:Name="mySolidColorBrush" Color="#00FF00" />
            </Rectangle.Fill>
        </Rectangle>
    </StackPanel>
</StackPanel>

private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

注解

使用 By 属性按指定量对颜色进行动画处理时，By 属性的十六进制值将添加到起始颜色的十六进制值。 如果使用的是命名颜色，请记住，名称仅表示 一个 rgb 值，而该值就是要添加的内容。

例如，如果通过 #0000FF (Blue) 对#FF0000 (红色) 进行动画处理，则最终颜色#FF00FF (Fuchsia) 。 但是，如果对 #0000FF (Blue) #FF00FF (Fuchsia) 进行动画处理，则最终颜色仍#FF00FF (Fuchsia) 。

可以自行设置 By 属性，也可以使用 From 属性设置。 如果同时设置“By”和“ To ”属性，则忽略“By”值，动画以“To”值结尾。

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