FrameworkContentElement.BeginStoryboard FrameworkContentElement.BeginStoryboard FrameworkContentElement.BeginStoryboard Method

定義

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

オーバーロード

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

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

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

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

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

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

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

指定したストーリーボードに含まれるアクションのシーケンスを開始します。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 Storyboard Storyboard

開始するストーリーボード。The storyboard to begin.

注釈

署名を使用しない、 isControllable、パラメーター、そのパラメーターが指定されている場合またはfalseアニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. そのため、アニメーションは、1 回実行された後再開できません。Therefore the animation cannot be restarted after being run once. アニメーションを制御することも必要であること、ストーリー ボードの名前付きまたはコード内のインスタンスとしてアクセス可能であることに注意してください。Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

プロパティが既にアニメーション化されていた場合に行う処理を指定するオプションを使用して、指定したストーリーボードに含まれるアクションのシーケンスを開始します。Begins the sequence of actions that are contained in the provided storyboard, with options specified for what should occur 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 Storyboard Storyboard

開始するストーリーボード。The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

ストーリーボードに記述されたプロパティが既にアニメーション化されている場合に使用する動作を表す列挙値。A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

注釈

署名を使用しない、 isControllable、パラメーター、そのパラメーターが指定されている場合またはfalseアニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. そのため、アニメーションは、1 回実行された後再開できません。Therefore the animation cannot be restarted after being run once. アニメーションを制御することも必要であること、ストーリー ボードの名前付きまたはコード内のインスタンスとしてアクセス可能であることに注意してください。Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

使用して、Compose HandoffBehaviorUsing the Compose HandoffBehavior

適用すると、 StoryboardAnimationTimeline、または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:

これは主に、有効期間が長いオブジェクトでのアニメーションの問題です。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.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

開始後のアニメーションの制御の状態を指定して、指定したストーリーボードに含まれるアクションのシーケンスを開始します。Begins the sequence of actions that are 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

パラメーター

storyboard
Storyboard Storyboard Storyboard

開始するストーリーボード。The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

ストーリーボードに記述されたプロパティが既にアニメーション化されている場合に使用する、動作を表す列挙型の値。A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean Boolean Boolean

アニメーションを起動した後に、アニメーションを制御できるかどうか (一時停止できるかどうか) を宣言します。Declares whether the animation is controllable (can be paused) after it is started.

注釈

署名を使用しない、 isControllable、パラメーター、そのパラメーターが指定されている場合またはfalseアニメーションに関連付けられているタイムラインのクロックが"Fill"期間に達するとすぐに削除されます。For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. そのため、アニメーションは、1 回実行された後再開できません。Therefore the animation cannot be restarted after being run once. アニメーションを制御することも必要であること、ストーリー ボードの名前付きまたはコード内のインスタンスとしてアクセス可能であることに注意してください。Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

使用して、Compose HandoffBehaviorUsing the Compose HandoffBehavior

適用すると、 StoryboardAnimationTimeline、または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 these 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:

これは主に、有効期間が長いオブジェクトでのアニメーションの問題です。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.

適用対象