UIElement.BeginAnimation メソッド

定義

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。

オーバーロード

BeginAnimation(DependencyProperty, AnimationTimeline)

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

この要素のアニメーション化対象のプロパティを指定して、特定のアニメーションを開始します。プロパティの既存のアニメーションが実行中である場合の動作も指定できます。

BeginAnimation(DependencyProperty, AnimationTimeline)

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。

public:
 virtual void BeginAnimation(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationTimeline ^ animation);
public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation);
abstract member BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline -> unit
override this.BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline -> unit
Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline)

パラメーター

dp
DependencyProperty

依存関係プロパティの識別子として指定された、アニメーション化するプロパティ。

animation
AnimationTimeline

開始するアニメーションのタイムライン。

実装

次の例では、アニメーションを作成し、それを割り当ててから開始する呼び出し BeginAnimation を行います。

// 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);
' Animate the button's width.
Dim widthAnimation As New DoubleAnimation(120, 300, TimeSpan.FromSeconds(5))
widthAnimation.RepeatBehavior = RepeatBehavior.Forever
widthAnimation.AutoReverse = True
animatedButton.BeginAnimation(Button.WidthProperty, widthAnimation)

注釈

プロパティがアニメーション化されているかどうかを確認するときは、アニメーション化されていない開始点を超える最初のフレームがレンダリングされるときにアニメーションが開始され、アニメーションと見なされることに注意してください。

for のBeginTime場合はnull、現在のアニメーションが削除され、プロパティの現在の値が保持animationされます。

値全体 animation が指定されている null場合、すべてのアニメーションがプロパティから削除され、プロパティ値は基本値に戻ります。 ただし、最初に関連付けられたアニメーション タイムラインは停止しません。 そのタイムラインに割り当てられたその他のアニメーションは引き続き実行されます。

適用対象

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

この要素のアニメーション化対象のプロパティを指定して、特定のアニメーションを開始します。プロパティの既存のアニメーションが実行中である場合の動作も指定できます。

public:
 virtual void BeginAnimation(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationTimeline ^ animation, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
abstract member BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline * System.Windows.Media.Animation.HandoffBehavior -> unit
Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)

パラメーター

dp
DependencyProperty

依存関係プロパティの識別子として指定された、アニメーション化するプロパティ。

animation
AnimationTimeline

適用されるアニメーションのタイムライン。

handoffBehavior
HandoffBehavior

プロパティ値に既に影響している現在の (実行中の) アニメーションと新しいアニメーションが対話する方法を指定する列挙値。

実装

次の例では、リソースから既存のアニメーションを取得し、指定したハンドオフ動作を使用して呼び出す BeginAnimation ハンドラーを実装します。

private void myFrameNavigated(object sender, NavigationEventArgs args)
{
    DoubleAnimation myFadeInAnimation = (DoubleAnimation)this.Resources["MyFadeInAnimationResource"];
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace);
}
Private Sub myFrameNavigated(ByVal sender As Object, ByVal args As NavigationEventArgs)
    Dim myFadeInAnimation As DoubleAnimation = CType(Me.Resources("MyFadeInAnimationResource"), DoubleAnimation)
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace)
End Sub

注釈

プロパティがアニメーション化されているかどうかを確認するときは、アニメーション化されていない開始点を超える最初のフレームがレンダリングされるときにアニメーションが開始され、アニメーションと見なされることに注意してください。

for のBeginTime場合はnull、現在のアニメーションが削除され、プロパティの現在の値が保持animationされます。

値全体 animation が指定されている null場合、すべてのアニメーションがプロパティから削除され、プロパティ値は基本値に戻ります。 ただし、最初に関連付けられたアニメーション タイムラインは停止しません。 そのタイムラインに割り当てられたその他のアニメーションは引き続き実行されます。

適用対象