ColorAnimation.By 屬性

定義

命名空間:

Windows.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 (藍色) 以動畫 #FF0000 (紅色) ，最終色彩會 #FF00FF (Fuchsia) 。 不過，如果您透過 #0000FF (Blue) 建立 #FF00FF (Fuchsia) 動畫，最終色彩仍會 #FF00FF (Fuchsia) 。

您可以單獨或使用 From 屬性來設定 By 屬性。 如果您同時設定 By 和 To 屬性，則會忽略 By 值，而且動畫會以 To 值結束。

• 僅限： 動畫會從要產生動畫效果的屬性基底值或先前動畫的輸出值到該值的總和以及 By 屬性所指定的值進行。
• 寄件者和依據： 動畫會從 From 屬性所指定的值，前進到 From 和 By 屬性的總和所指定的值。