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.

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

場合、全体animation値はnull、すべてのアニメーションがプロパティから削除、およびプロパティ値をその基本値に戻ります。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.

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

場合、全体animation値はnull、すべてのアニメーションがプロパティから削除、およびプロパティ値をその基本値に戻ります。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.

適用対象