FrameworkContentElement.BeginStoryboard Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Zahájí posloupnost akcí obsažených v poskytnuté scénáře.

Přetížení

BeginStoryboard(Storyboard)	Zahájí posloupnost akcí obsažených v poskytnuté scénáře.
BeginStoryboard(Storyboard, HandoffBehavior)	Začíná posloupnost akcí obsažených v poskytnuté scénáře s možnostmi zadanými pro to, co by se mělo stát, pokud je vlastnost již animovaný.
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)	Zahájí posloupnost akcí obsažených v poskytnutém scénáři se zadaným stavem pro kontrolu animace po jejím spuštění.

BeginStoryboard(Storyboard)

Zahájí posloupnost akcí obsažených v poskytnuté scénáře.

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

storyboard

Storyboard

Scénář, který má začít.

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.

BeginStoryboard(Storyboard, HandoffBehavior)

Začíná posloupnost akcí obsažených v poskytnuté scénáře s možnostmi zadanými pro to, co by se mělo stát, pokud je vlastnost již animovaný.

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

storyboard

Storyboard

Scénář, který má začít.

handoffBehavior

HandoffBehavior

Hodnota výčtu, která popisuje chování, které se má použít, pokud je vlastnost popsaná ve scénáři již animované.

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.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Zahájí posloupnost akcí obsažených v poskytnutém scénáři se zadaným stavem pro kontrolu animace po jejím spuštění.

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

storyboard

Storyboard

Scénář, který má začít.

handoffBehavior

HandoffBehavior

Hodnota výčtu, která popisuje chování, které se má použít, pokud je vlastnost popsaná ve scénáři již animované.

isControllable

Boolean

Deklaruje, jestli je animace po spuštění ovládatelná (lze ji pozastavit).

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.