UIElement.ApplyAnimationClock 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

將動畫套用至這個專案上的指定相依性屬性。

多載

ApplyAnimationClock(DependencyProperty, AnimationClock)	將動畫套用至這個專案上的指定相依性屬性。 任何現有的動畫會停止，並以新的動畫取代。
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	將動畫套用至這個專案上的指定相依性屬性，並能夠指定如果屬性已經有執行中的動畫，會發生什麼事。

備註

這個方法已密封且無法覆寫。

ApplyAnimationClock(DependencyProperty, AnimationClock)

將動畫套用至這個專案上的指定相依性屬性。 任何現有的動畫會停止，並以新的動畫取代。

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock);

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);

abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit

Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock)

參數

dp

DependencyProperty

要產生動畫效果之屬性的標識碼。

clock

AnimationClock

控制及宣告動畫的動畫時鐘。

實作

ApplyAnimationClock(DependencyProperty, AnimationClock)

範例

在下列範例中，RectanglemyAnimatedRectangle 藉由呼叫 ApplyAnimationClock 來套用特定的計時動畫。

// Create a DoubleAnimation to
// animate its width.
DoubleAnimation widthAnimation = 
    new DoubleAnimation(
        100,
        500, 
        new Duration(TimeSpan.FromSeconds(5)));
//widthAnimation.RepeatBehavior = RepeatBehavior.Forever;
widthAnimation.AutoReverse = true;
widthAnimation.SpeedRatio = 0.5;
        
// Create a clock from the animation.
myControllableClock = widthAnimation.CreateClock();

// Apply the clock to the rectangle's Width property.
animatedRectangle.ApplyAnimationClock(
    Rectangle.WidthProperty, myControllableClock);

' Create a DoubleAnimation to
' animate its width.
'widthAnimation.RepeatBehavior = RepeatBehavior.Forever
Dim widthAnimation As New DoubleAnimation(100, 500, New Duration(TimeSpan.FromSeconds(5))) With {
    .AutoReverse = True,
    .SpeedRatio = 0.5
}

    ' Create a clock from the animation.
myControllableClock = widthAnimation.CreateClock()

' Apply the clock to the rectangle's Width property.
animatedRectangle.ApplyAnimationClock(Rectangle.WidthProperty, myControllableClock)

備註

若要從屬性中移除動畫，請將該屬性的識別元指定為 dp，並將 clock 指定為 null。 這會移除動畫，而動畫屬性會設定為其基底值。 不過，原始關聯的動畫時鐘不會停止。 指派給該時鐘的任何其他動畫都會繼續執行。

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

將動畫套用至這個專案上的指定相依性屬性，並能夠指定如果屬性已經有執行中的動畫，會發生什麼事。

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit

Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock, handoffBehavior As HandoffBehavior)

參數

dp

DependencyProperty

要產生動畫效果的屬性。

clock

AnimationClock

控制及宣告動畫的動畫時鐘。

handoffBehavior

HandoffBehavior

列舉的值。 默認值為 SnapshotAndReplace，這會停止任何現有的動畫，並將 取代為新的動畫。

實作

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

備註

若要從屬性中移除動畫，請將該屬性的識別元指定為 dp，並將 clock 指定為 null。 這會移除動畫，而動畫屬性會設定為其基底值。 不過，原始關聯的動畫時鐘不會停止。 指派給該時鐘的任何其他動畫都會繼續執行。