FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard Method

指定したストーリーボードに含まれるアクションのシーケンスを開始します。Begins the sequence of actions that are contained in the provided storyboard.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unit

パラメーター

例

次の例ではStoryboard 、リソースからを取得し、 Storyboard内部イベントがクラスで処理されたときに実行します。The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}

Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
	Dim s As Storyboard

	s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
	Me.BeginStoryboard(s)
End Sub

注釈

一般的なアニメーションのシナリオでは、この方法は使用しません。Most typical animation scenarios do not use this method. 通常Storyboardは、マークアップでBeginStoryboard要素または要素を作成し、要素のEventTriggerコンテンツとして配置します。Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. イベントによってトリガーされると、アニメーションが実行されます。When triggered by the event, the animation then runs. のコントロールのほとんどの側面はStoryboard 、マークアップで公開されるプロパティによってアドレス指定できます。Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

パラメーターまたはパラメーターを使用isControllableしないシグネチャについてはfalse、アニメーションが "塗りつぶし" 期間に到達するとすぐに、アニメーションに関連付けられているタイムラインクロックが削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. そのため、1回実行した後にアニメーションを再起動することはできません。Therefore the animation cannot be restarted after running once. アニメーションを制御するには、ストーリーボードがX:Name ディレクティブを持つか、コード内で参照によってアクセスできる必要もあります。Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

プロパティが既にアニメーション化されていた場合にどうするかを指定するオプションを使用して、指定したストーリーボードに含まれるアクションのシーケンスを開始します。Begins the sequence of actions contained in the provided storyboard, with options specified for what should happen if the property is already animated.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unit

パラメーター

例

次の例ではStoryboard 、リソースからを取得し、 Storyboard内部イベントがクラスで処理されたときに実行します。The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}

Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
	Dim s As Storyboard

	s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
	Me.BeginStoryboard(s)
End Sub

注釈

一般的なアニメーションのシナリオでは、この方法は使用しません。Most typical animation scenarios do not use this method. 通常Storyboardは、マークアップでBeginStoryboard要素または要素を作成し、要素のEventTriggerコンテンツとして配置します。Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. イベントによってトリガーされると、アニメーションが実行されます。When triggered by the event, the animation then runs. のコントロールのほとんどの側面はStoryboard 、マークアップで公開されるプロパティによってアドレス指定できます。Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

パラメーターまたはパラメーターを使用isControllableしないシグネチャについてはfalse、アニメーションが "塗りつぶし" 期間に到達するとすぐに、アニメーションに関連付けられているタイムラインクロックが削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. そのため、1回実行した後にアニメーションを再起動することはできません。Therefore the animation cannot be restarted after running once. アニメーションを制御するには、ストーリーボードがX:Name ディレクティブを持つか、コード内で参照によってアクセスできる必要もあります。Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

ハンドオフ動作は、のBeginStoryboard属性として指定できます。Handoff behavior can be specified as an attribute of BeginStoryboard.

作成 HandoffBehavior の使用Using the Compose HandoffBehavior

をStoryboard使用AnimationClock AnimationTimelineしてClockプロパティに、、またはを適用すると、以前にそのプロパティに関連付けられていたすべてのオブジェクトが引き続きシステムリソースを使用します。タイミングシステムは、HandoffBehavior Compose時計を自動的に削除しません。When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

を使用Composeして多数のクロックを適用するときのパフォーマンスの問題を回避するには、アニメーション化されたプロパティの完了後に、構成クロックを削除する必要があります。To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. クロックを削除するには、いくつかの方法があります。There are several ways to remove a clock:

• プロパティからすべてのクロックを削除するにApplyAnimationClock(DependencyProperty, AnimationClock)は、アニメーション化されたオブジェクトのメソッドまたはBeginAnimation(DependencyProperty, AnimationTimeline)メソッドを使用します。To remove all clocks from a property, use the ApplyAnimationClock(DependencyProperty, AnimationClock) or BeginAnimation(DependencyProperty, AnimationTimeline) method of the animated object. アニメーション化するプロパティを最初のパラメーターとしてnull指定し、2番目のパラメーターとして指定します。Specify the property being animated as the first parameter, and null as the second. これにより、プロパティからすべてのアニメーションクロックが削除されます。This removes all animation clocks from the property.

• クロックのリストからAnimationClock特定のを削除するには、 ControllerのプロパティAnimationClockを使用してClockController ClockControllerを取得し、 Removeのメソッドを呼び出します。To remove a specific AnimationClock from a list of clocks, use the Controller property of the AnimationClock to retrieve a ClockController, then call the Remove method of the ClockController. これは通常、クロックのCompletedイベントハンドラーで実行されます。This is typically done in the Completed event handler for a clock. によってClockController制御できるのはルートクロックのみであることに注意してくださいnull。子クロックのプロパティはControllerを返します。Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returns null. また、クロックのCompleted有効期間が無期限の場合は、イベントが発生しないことにも注意してください。Note also that the Completed event is not raised if the effective duration of the clock is forever. その場合、ユーザーはを呼び出すRemoveタイミングを決定する必要があります。In that case, the user must determine when to call Remove.

これは主に、有効期間が長いオブジェクトでのアニメーションの問題です。This is primarily an issue for animations on objects that have a long lifetime. オブジェクトがガベージコレクションされると、そのクロックも切断され、ガベージコレクトされます。When an object is garbage collected, its clocks are also disconnected and garbage collected.

クロックオブジェクトの詳細については、「アニメーションとタイミングシステムの概要」を参照してください。For more information about clock objects, see Animation and Timing System Overview.

開始後のアニメーションの制御の状態を指定して、指定したストーリーボードに含まれるアクションのシーケンスを開始します。Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unit

パラメーター

注釈

一般的なアニメーションのシナリオでは、この方法は使用しません。Most typical animation scenarios do not use this method. 通常Storyboardは、マークアップでBeginStoryboard要素または要素を作成し、要素のEventTriggerコンテンツとして配置します。Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. イベントによってトリガーされると、アニメーションが実行されます。When triggered by the event, the animation then runs. のコントロールのほとんどの側面はStoryboard 、マークアップで公開されるプロパティによってアドレス指定できます。Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

パラメーターまたはパラメーターを使用isControllableしないシグネチャについてはfalse、アニメーションが "塗りつぶし" 期間に到達するとすぐに、アニメーションに関連付けられているタイムラインクロックが削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. そのため、1回実行した後にアニメーションを再起動することはできません。Therefore the animation cannot be restarted after running once. アニメーションを制御するには、ストーリーボードがX:Name ディレクティブを持つか、コード内で参照によってアクセスできる必要もあります。Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

ハンドオフ動作は、のBeginStoryboard属性として指定できます。Handoff behavior can be specified as an attribute of BeginStoryboard.

作成 HandoffBehavior の使用Using the Compose HandoffBehavior

をStoryboard使用AnimationClock AnimationTimelineしてClockプロパティに、、またはを適用すると、以前にそのプロパティに関連付けられていたすべてのオブジェクトが引き続きシステムリソースを使用します。タイミングシステムは、HandoffBehavior Compose時計を自動的に削除しません。When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

を使用Composeして多数のクロックを適用するときのパフォーマンスの問題を回避するには、アニメーション化されたプロパティの完了後に、構成クロックを削除する必要があります。To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. クロックを削除するには、いくつかの方法があります。There are several ways to remove a clock:

• プロパティからすべてのクロックを削除するにApplyAnimationClock(DependencyProperty, AnimationClock)は、アニメーション化されたオブジェクトのメソッドまたはBeginAnimation(DependencyProperty, AnimationTimeline)メソッドを使用します。To remove all clocks from a property, use the ApplyAnimationClock(DependencyProperty, AnimationClock) or BeginAnimation(DependencyProperty, AnimationTimeline) method of the animated object. アニメーション化するプロパティを最初のパラメーターとしてnull指定し、2番目のパラメーターとして指定します。Specify the property being animated as the first parameter, and null as the second. これにより、プロパティからすべてのアニメーションクロックが削除されます。This removes all animation clocks from the property.

• クロックのリストからAnimationClock特定のを削除するには、 ControllerのプロパティAnimationClockを使用してClockController ClockControllerを取得し、 Removeのメソッドを呼び出します。To remove a specific AnimationClock from a list of clocks, use the Controller property of the AnimationClock to retrieve a ClockController, then call the Remove method of the ClockController. これは通常、クロックのCompletedイベントハンドラーで実行されます。This is typically done in the Completed event handler for a clock. によってClockController制御できるのはルートクロックのみであることに注意してくださいnull。子クロックのプロパティはControllerを返します。Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returns null. また、クロックのCompleted有効期間が無期限の場合は、イベントが発生しないことにも注意してください。Note also that the Completed event is not raised if the effective duration of the clock is forever. その場合、ユーザーはを呼び出すRemoveタイミングを決定する必要があります。In that case, the user must determine when to call Remove.

これは主に、有効期間が長いオブジェクトでのアニメーションの問題です。This is primarily an issue for animations on objects that have a long lifetime. オブジェクトがガベージコレクションされると、そのクロックも切断され、ガベージコレクトされます。When an object is garbage collected, its clocks are also disconnected and garbage collected.

クロックオブジェクトの詳細については、「アニメーションとタイミングシステムの概要」を参照してください。For more information about clock objects, see Animation and Timing System Overview.