UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation Method

定義

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。Starts an animation for a specified animated property on this element.

オーバーロード

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。Starts an animation for a specified animated property on this element.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

この要素のアニメーション化対象のプロパティを指定して、特定のアニメーションを開始します。プロパティの既存のアニメーションが実行中である場合の動作も指定できます。Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

この要素のアニメーション化対象のプロパティを指定して、アニメーションを開始します。Starts an animation for a specified animated property on this element.

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 DependencyProperty DependencyProperty DependencyProperty

依存関係プロパティの識別子として指定された、アニメーション化するプロパティ。The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

開始するアニメーションのタイムライン。The timeline of the animation to start.

実装

次の例では、アニメーションを作成し、それをBeginAnimation割り当ててから、を呼び出して開始します。The following example creates an animation, assigns it, and then calls BeginAnimation to start it.

// 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)

注釈

プロパティがアニメーション化されているかどうかを確認する場合は、アニメーションが開始され、アニメーション化されていない開始点を超える最初のフレームがレンダリングされると、アニメーションがアニメーション化されたと見なされます。When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

BeginTimeのがのnull場合、現在のアニメーションはすべて削除され、プロパティの現在の値が保持されます。 animationIf the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

値全体animationnullの場合は、すべてのアニメーションがプロパティから削除され、プロパティ値はその基本値に戻ります。If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. ただし、最初に関連付けられたアニメーションタイムラインは停止しません。However, the originally associated animation timeline is not stopped. そのタイムラインに割り当てられたその他のアニメーションは、引き続き実行されます。Any other animations assigned to that timeline will continue to run.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

この要素のアニメーション化対象のプロパティを指定して、特定のアニメーションを開始します。プロパティの既存のアニメーションが実行中である場合の動作も指定できます。Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

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

パラメーター

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

依存関係プロパティの識別子として指定された、アニメーション化するプロパティ。The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

適用されるアニメーションのタイムライン。The timeline of the animation to be applied.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

プロパティ値に既に影響している現在の (実行中の) アニメーションと新しいアニメーションが対話する方法を指定する列挙値。A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

実装

次の例では、既存のアニメーションをリソースから取得し、指定さBeginAnimationれたハンドオフ動作でを呼び出すハンドラーを実装します。The following example implements a handler that obtains an existing animation from a resource and then calls BeginAnimation with a specified handoff behavior.

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

注釈

プロパティがアニメーション化されているかどうかを確認する場合は、アニメーションが開始され、アニメーション化されていない開始点を超える最初のフレームがレンダリングされると、アニメーションがアニメーション化されたと見なされます。When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

BeginTimeのがのnull場合、現在のアニメーションはすべて削除され、プロパティの現在の値が保持されます。 animationIf the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

値全体animationnullの場合は、すべてのアニメーションがプロパティから削除され、プロパティ値はその基本値に戻ります。If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. ただし、最初に関連付けられたアニメーションタイムラインは停止しません。However, the originally associated animation timeline is not stopped. そのタイムラインに割り当てられたその他のアニメーションは、引き続き実行されます。Any other animations assigned to that timeline will continue to run.

適用対象