SingleAnimation.By 屬性

定義

命名空間:

System.Windows.Media.Animation

組件:

PresentationCore.dll

取得或設定動畫變更其起始值的總金額。

public:
 property Nullable<float> By { Nullable<float> get(); void set(Nullable<float> value); };

public float? By { get; set; }

member this.By : Nullable<single> with get, set

Public Property By As Nullable(Of Single)

屬性值

Nullable<Single>

動畫變更其起始值的總金額。 預設值為 null。

備註

當您想要以動畫顯示特定數量的值時，請使用 By 屬性，而不是指定起始或結束值。 您也可以將 By 屬性與 From 屬性搭配使用。 下表摘要說明 From、To和 By 屬性如何一起使用或個別判斷動畫的目標值。

指定的屬性	產生的行為
From	動畫會根據上一個動畫的設定方式，從 From 屬性所指定的值，進行到要建立動畫之屬性的基底值，或從上一個動畫的輸出值進行。
From 和 To	動畫會從 From 屬性所指定的值，到 To 屬性所指定的值。
From 和 By	動畫會從 From 屬性所指定的值移至 From 和 By 屬性的總和所指定的值。
To	動畫會從動畫屬性的基底值或先前動畫的輸出值移至 To 屬性所指定的值。
By	動畫會從要產生動畫效果的屬性基底值或先前動畫的輸出值，到該值的總和，以及 By 屬性所指定的值。

注意 如果您同時設定 To 和 By 屬性，則會優先使用 To 屬性，並忽略 By 屬性。

若要使用其他插補方法或在兩個以上的目標值之間產生動畫效果，請使用 SingleAnimationUsingKeyFrames 物件。

XAML 屬性使用方式

< 物件By=“Single”/>

-或-

< 物件By=“{x：Null 標記延伸}”/>

相依性屬性資訊

標識元欄位	ByProperty
設定為 true 的元數據屬性	沒有

另請參閱

• From
• To