UIElement.BeginAnimation メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

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

オーバーロード

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(DependencyProperty, 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(DependencyProperty, AnimationTimeline, 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場合、すべてのアニメーションがプロパティから削除され、プロパティ値は基本値に戻ります。 ただし、最初に関連付けられたアニメーション タイムラインは停止しません。 そのタイムラインに割り当てられたその他のアニメーションは引き続き実行されます。