HandoffBehavior 列挙型


プロパティに既に適用されている既存のアニメーションと新しいアニメーションが相互作用する方法を指定します。Specifies how new animations interact with any existing ones that are already applied to a property.

public enum class HandoffBehavior
public enum HandoffBehavior
type HandoffBehavior = 
Public Enum HandoffBehavior


Compose 1

新しいアニメーションは、複合チェーンの末尾に新しいアニメーションを追加することにより、既存のアニメーションに組み合わされます。New animations are combined with existing animations by appending the new animations to the end of the composition chain.

SnapshotAndReplace 0

新しいアニメーションは、プロパティに適用された既存のアニメーションを置き換えます。New animations replace any existing animations on the properties to which they are applied.


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

構成を使用して多数のクロックを適用するときのパフォーマンスの問題を回避するには、完了後にアニメーション化されたプロパティから作成クロックを削除する必要があります。To avoid performance issues when you apply a large number of clocks 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 will also be disconnected and garbage collected.

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