BeginStoryboard.HandoffBehavior Vlastnost

Definice

Obor názvů:

System.Windows.Media.Animation

Sestavení:

PresentationFramework.dll

Získá nebo nastaví správné chování hand-off pro spuštění hodiny animace v tomto scénáři.

public:
 property System::Windows::Media::Animation::HandoffBehavior HandoffBehavior { System::Windows::Media::Animation::HandoffBehavior get(); void set(System::Windows::Media::Animation::HandoffBehavior value); };

public System.Windows.Media.Animation.HandoffBehavior HandoffBehavior { get; set; }

member this.HandoffBehavior : System.Windows.Media.Animation.HandoffBehavior with get, set

Public Property HandoffBehavior As HandoffBehavior

Hodnota vlastnosti

HandoffBehavior

Jedna z hodnot výčtu HandoffBehavior . Výchozí hodnota je SnapshotAndReplace.

Poznámky

Použití HandoffBehavior psaní

Když použijete Storyboardvlastnost , AnimationTimelinenebo AnimationClock na vlastnost pomocí HandoffBehavior.Compose, všechny Clock objekty dříve přidružené k této vlastnosti budou dál využívat systémové prostředky. Systém časování tyto hodiny automaticky neodebere.

Chcete-li zabránit problémům s výkonem při použití velkého počtu hodin pomocí Composenástroje , měli byste po dokončení odebrat hodiny psaní z animované vlastnosti. Hodiny můžete odebrat několika způsoby:

• Pokud chcete z vlastnosti odebrat všechny hodiny, použijte metodu ApplyAnimationClock(DependencyProperty, AnimationClock) nebo BeginAnimation(DependencyProperty, AnimationTimeline) animovaného objektu. Jako první parametr zadejte vlastnost, která se má oživovat, a null jako druhý parametr. Tím se z vlastnosti odeberou všechny hodiny animace.

• Chcete-li odebrat konkrétní AnimationClock ze seznamu hodin, použijte Controller vlastnost AnimationClock k načtení objektu ClockControllera pak volání Remove metody ClockController. To se obvykle provádí v obslužné rutině Completed události pro hodiny. Všimněte si, že pouze kořenové hodiny mohou být řízeny ; ClockControllerController vlastnost podřízených hodin vrátí null. Všimněte si také, že Completed událost není volána, pokud je platná doba trvání hodin navždy. V takovém případě musí uživatel určit, kdy má volat Remove.

Jedná se především o problém u animací u objektů, které mají dlouhou životnost. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolněny.

Další informace o objektech hodin najdete v tématu Přehled systému animací a časování.