UIElement.BeginAnimation 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

針對這個項目之指定的動畫屬性，開始播放動畫。

多載

BeginAnimation(DependencyProperty, AnimationTimeline)	針對這個項目之指定的動畫屬性，開始播放動畫。
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	針對此項目上指定的動畫屬性啟動特定動畫，且可以選擇指定如果屬性已經有執行中的動畫時會發生何種情況。

BeginAnimation(DependencyProperty, AnimationTimeline)

針對這個項目之指定的動畫屬性，開始播放動畫。

C#

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation);

參數

dp

DependencyProperty

要顯示動畫的屬性，該屬性會指定為相依性屬性識別項。

animation

AnimationTimeline

啟動動畫的時刻表。

實作

BeginAnimation(DependencyProperty, AnimationTimeline)

範例

下列範例會建立動畫、指派動畫，然後呼叫 BeginAnimation 來啟動它。

C#

// Animate the button's width.
DoubleAnimation widthAnimation = 
    new DoubleAnimation(120, 300, TimeSpan.FromSeconds(5));
widthAnimation.RepeatBehavior = RepeatBehavior.Forever;
widthAnimation.AutoReverse = true;
animatedButton.BeginAnimation(Button.WidthProperty, widthAnimation);

備註

當您檢查屬性是否為動畫時，請注意，當非動畫起點以外的第一個畫面呈現時，動畫會開始並視為動畫。

BeginTime如果 的 animation 為 null ，則會移除任何目前的動畫，並保留屬性的目前值。

如果整個 animation 值為 null ，則會從 屬性中移除所有動畫，而 屬性值會還原為其基底值。 不過，原始關聯的動畫時間軸不會停止。 指派給該時程表的任何其他動畫都會繼續執行。

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

針對此項目上指定的動畫屬性啟動特定動畫，且可以選擇指定如果屬性已經有執行中的動畫時會發生何種情況。

C#

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

參數

dp

DependencyProperty

要顯示動畫的屬性，該屬性會指定為相依性屬性識別項。

animation

AnimationTimeline

套用動畫的時刻表。

handoffBehavior

HandoffBehavior

一個列舉值，這個值指定新的動畫如何與已經影響屬性值的任何目前 (執行中) 動畫互動。

實作

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

範例

下列範例會實作處理常式，從資源取得現有的動畫，然後使用指定的遞交行為呼叫 BeginAnimation 。

C#

private void myFrameNavigated(object sender, NavigationEventArgs args)
{
    DoubleAnimation myFadeInAnimation = (DoubleAnimation)this.Resources["MyFadeInAnimationResource"];
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace);
}

備註

當您檢查屬性是否為動畫時，請注意，當非動畫起點以外的第一個畫面呈現時，動畫會開始並視為動畫。

BeginTime如果 的 animation 為 null ，則會移除任何目前的動畫，並保留屬性的目前值。

如果整個 animation 值為 null ，則會從 屬性中移除所有動畫，而 屬性值會還原為其基底值。 不過，原始關聯的動畫時間軸不會停止。 指派給該時程表的任何其他動畫都會繼續執行。