FrameworkContentElement.BeginStoryboard Metoda

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

Public Sub BeginStoryboard (storyboard As Storyboard)

Parametry

Poznámky

Pro podpisy, které nepoužívají isControllable, parametr nebo pokud je tento parametr zadán false, časové osy přidružené k animaci se odeberou, jakmile dosáhne období "Vyplnit". Proto animaci nelze po spuštění jednou restartovat. Mějte na paměti, že ovládání animace také vyžaduje, aby se scénář pojmenoval nebo byl přístupný jako instance v kódu.

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

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)

Parametry

Poznámky

Pro podpisy, které nepoužívají isControllable, parametr nebo pokud je tento parametr zadán false, časové osy přidružené k animaci se odeberou, jakmile dosáhne období "Vyplnit". Proto animaci nelze po spuštění jednou restartovat. Mějte na paměti, že ovládání animace také vyžaduje, aby se scénář pojmenoval nebo byl přístupný jako instance v kódu.

Použití nástroje Compose HandoffBehavior

Při použití Storyboard, AnimationTimelinenebo AnimationClock na vlastnost pomocí ComposeHandoffBehavior, všechny objekty Clock dříve přidružené k této vlastnosti nadále využívat systémové prostředky; systém časování automaticky neodebere hodiny.

Abyste se vyhnuli problémům s výkonem při použití velkého počtu hodin pomocí Compose, měli byste po dokončení odebrat psaní hodin z animované vlastnosti. Hodiny můžete odebrat několika způsoby:

• Chcete-li odebrat všechny hodiny z vlastnosti, použijte ApplyAnimationClock(DependencyProperty, AnimationClock) nebo BeginAnimation(DependencyProperty, AnimationTimeline) metodu animovaného objektu. Zadejte vlastnost, která se animuje jako první parametr, a null jako druhý. Tím se z vlastnosti odeberou všechny hodiny animace.

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

Jedná se především o problém s animacemi na objektech, které mají dlouhou životnost. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolňování paměti.

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

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

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)

Parametry

Poznámky

Pro podpisy, které nepoužívají isControllable, parametr nebo pokud je tento parametr zadán false, časové osy přidružené k animaci se odeberou, jakmile dosáhne období "Vyplnit". Proto animaci nelze po spuštění jednou restartovat. Mějte na paměti, že ovládání animace také vyžaduje, aby se scénář pojmenoval nebo byl přístupný jako instance v kódu.

Použití nástroje Compose HandoffBehavior

Při použití Storyboard, AnimationTimelinenebo AnimationClock na vlastnost pomocí ComposeHandoffBehavior, všechny objekty Clock dříve přidružené k této vlastnosti nadále využívat systémové prostředky; systém časování tyto hodiny automaticky neodebere.

Abyste se vyhnuli problémům s výkonem při použití velkého počtu hodin pomocí Compose, měli byste po dokončení odebrat psaní hodin z animované vlastnosti. Hodiny můžete odebrat několika způsoby:

• Chcete-li odebrat všechny hodiny z vlastnosti, použijte ApplyAnimationClock(DependencyProperty, AnimationClock) nebo BeginAnimation(DependencyProperty, AnimationTimeline) metodu animovaného objektu. Zadejte vlastnost, která se animuje jako první parametr, a null jako druhý. Tím se z vlastnosti odeberou všechny hodiny animace.

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

Jedná se především o problém s animacemi na objektech, které mají dlouhou životnost. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolňování paměti.

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