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アニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。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アニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。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.

使用して、Compose HandoffBehaviorUsing the Compose HandoffBehavior

適用すると、 Storyboard、 AnimationTimeline、またはAnimationClockにプロパティを使用して、 Compose HandoffBehavior、anyClock以前そのプロパティに関連付けられているオブジェクトは引き続きシステム リソースを消費しますタイミング システムは。時計を自動的に削除されません。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、呼び出して、Removeのメソッド、ClockControllerします。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、Controller子クロックのプロパティを返しますnullします。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アニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。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.

使用して、Compose HandoffBehaviorUsing the Compose HandoffBehavior

適用すると、 Storyboard、 AnimationTimeline、またはAnimationClockにプロパティを使用して、 Compose HandoffBehavior、anyClock以前そのプロパティに関連付けられているオブジェクトは引き続きシステム リソースを消費しますタイミング システムは。時計を自動的に削除されません。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、呼び出して、Removeのメソッド、ClockControllerします。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、Controller子クロックのプロパティを返しますnullします。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.