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í

Name	Description
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

U podpisů, které nepoužívají isControllableparametr , nebo pokud je tento parametr zadán false, jsou hodiny časové osy přidružené k animaci odebrány, 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

U podpisů, které nepoužívají isControllableparametr , nebo pokud je tento parametr zadán false, jsou hodiny časové osy přidružené k animaci odebrány, 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

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

Chcete-li zabránit 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á je animované 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 Controller vlastnost AnimationClock načíst ClockControllera potom volání Remove metody ClockController. To se obvykle provádí v Completed obslužné rutině události pro hodiny. Všimněte si, že pouze kořenové hodiny mohou být řízeny ClockControllerpomocí ; Controller vlastnost podřízených hodin vrací null. Všimněte si také, že Completed událost není vyvolána, pokud je efektivní doba trvání hodin 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

U podpisů, které nepoužívají isControllableparametr , nebo pokud je tento parametr zadán false, jsou hodiny časové osy přidružené k animaci odebrány, 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

Pokud použijete Storyboardvlastnost nebo AnimationTimelineAnimationClock vlastnost pomocí ComposeHandoffBehaviorobjektu , všechny Clock objekty dříve přidružené k této vlastnosti budou nadále 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í 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á je animované 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 Controller vlastnost AnimationClock načíst ClockControllera potom volání Remove metody ClockController. To se obvykle provádí v Completed obslužné rutině události pro hodiny. Všimněte si, že pouze kořenové hodiny mohou být řízeny ClockControllerpomocí ; Controller vlastnost podřízených hodin vrací null. Všimněte si také, že Completed událost není vyvolána, pokud je efektivní doba trvání hodin 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.