Timeline Třída

Reference

Definice

Obor názvů:: System.Windows.Media.Animation

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Definuje časový úsek.

public ref class Timeline abstract : System::Windows::Media::Animation::Animatable

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public abstract class Timeline : System.Windows.Media.Animation.Animatable

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type Timeline = class
    inherit Animatable

Public MustInherit Class Timeline
Inherits Animatable

Dědičnost: Object

DispatcherObject

DependencyObject

Freezable

Animatable
Timeline

Odvozené: System.Windows.Media.Animation.AnimationTimeline

System.Windows.Media.Animation.TimelineGroup

System.Windows.Media.MediaTimeline

Atributy: LocalizabilityAttribute RuntimeNamePropertyAttribute

Poznámky

Časová osa představuje časový úsek. Poskytuje vlastnosti, které umožňují určit délku tohoto segmentu, kdy má začít, kolikrát se bude opakovat, jak rychle bude v daném segmentu postupovat čas a další.

Třídy, které dědí z třídy časové osy, poskytují další funkce, jako jsou animace a přehrávání médií. Níže jsou uvedeny příklady některých různých typů dostupných specializovaných časových os.

Animace: Je AnimationTimeline typ časové osy, která vytváří výstupní hodnoty. Když přidružíte animaci k vlastnosti, animace aktualizuje hodnotu vlastnosti při přehrávání a tím ji "animuje". Úvod k animacím najdete v tématu Přehled animací. Informace o různých způsobech použití animací najdete v tématu Přehled technik animace vlastností.
MediaTimelines: A MediaTimeline je typ časové osy, která řídí přehrávání multimediálního souboru.
Paralelní časové osy: A ParallelTimeline je typ časové osy, která seskupuje jiné časové osy.
Scénáře: A Storyboard je speciální typ ParallelTimeline , který poskytuje informace o objektu a vlastnosti cílení na časové osy, které obsahuje. Další informace o Storyboard objektech najdete v přehledu scénářů.

Další informace o používání časových os najdete v tématu Přehled animací. Úvod k funkcím časování časových os najdete v tématu Přehled chování časování.

Datové vazby a animace časových os

Většina vlastností časové osy může být svázaná nebo animovaná; Vzhledem k tomu, jak systém časování funguje, se však časové osy vázané na data nebo animované časové osy nechovají jako jiné objekty vázané na data nebo animované objekty. Pokud chcete porozumět jejich chování, pomůže vám pochopit, co znamená aktivace časové osy.

Při použití časové osy se vytvoří kopie časové osy a jejích podřízených časových os. Tyto kopie jsou zablokované (jen pro čtení) a Clock objekty se z nich vytvářejí. Jsou to tyto hodiny, které dělají skutečnou práci na animování cílových vlastností. Pokud byla časová osa daty svázaná nebo animovaná, byl při vytváření hodin vytvořen snímek jejích aktuálních hodnot. I když se původní časová osa může i nadále měnit, její hodiny se nezmění.

Aby časová osa odrážela změny datových vazeb nebo animace, musí se její hodiny znovu vygenerovat. Hodiny se automaticky nevygenerují. Změny časové osy můžete použít několika způsoby:

Pokud časová osa je nebo patří do objektu Storyboard, můžete ji nastavit tak, aby odrážela změny tím, že znovu použijete její scénář pomocí BeginStoryboard metody nebo Begin . Vedlejším účinkem je také restartování animace. V kódu můžete použít metodu Seek k posunu scénáře zpět na předchozí pozici.
Pokud jste použili animaci přímo na vlastnost pomocí BeginAnimation metody , zavolejte metodu BeginAnimation znovu a předejte jí animaci, která byla upravena.
Pokud pracujete přímo na úrovni hodin, vytvořte a použijte novou sadu hodin a použijte ji k nahrazení předchozí sady vygenerovaných hodin.

Příklad animace vázané na data naleznete v ukázce klíčové spline animace .

Použití časové osy jako časovače

Hodiny časové osy budou postupovat pouze v případě, že je k ní přidružená obslužná rutina události nebo (v případě objektu AnimationClock ) přidružená k vlastnosti. Z tohoto důvodu (a dalších) se nedoporučuje používat Timeline jako časovač.

Konstruktory

Timeline()	Inicializuje novou instanci Timeline třídy .
Timeline(Nullable<TimeSpan>)	Inicializuje novou instanci Timeline třídy se zadaným BeginTimeparametrem .
Timeline(Nullable<TimeSpan>, Duration)	Inicializuje novou instanci Timeline třídy se zadanými BeginTime a Duration.
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)	Inicializuje novou instanci Timeline třídy se zadanými BeginTime, Durationa RepeatBehavior.

Pole

AccelerationRatioProperty	Identifikuje AccelerationRatio vlastnost závislosti.
AutoReverseProperty	Identifikuje AutoReverse vlastnost závislosti.
BeginTimeProperty	Identifikuje BeginTime vlastnost závislosti.
DecelerationRatioProperty	Určuje vlastnost DecelerationRatio závislosti.
DesiredFrameRateProperty	Identifikuje přidruženou DesiredFrameRate vlastnost.
DurationProperty	Identifikuje Duration vlastnost závislosti.
FillBehaviorProperty	Identifikuje FillBehavior vlastnost závislosti.
NameProperty	Identifikuje Name vlastnost závislosti.
RepeatBehaviorProperty	Identifikuje RepeatBehavior vlastnost závislosti.
SpeedRatioProperty	Určuje vlastnost SpeedRatio závislosti.

Vlastnosti

AccelerationRatio	Získá nebo nastaví hodnotu určující procento časové osy Duration strávené zrychlením průchodu času z nuly na maximální rychlost.
AutoReverse	Získá nebo nastaví hodnotu, která označuje, zda časová osa přehrává obráceně po dokončení iterace dopředné.
BeginTime	Získá nebo nastaví čas, kdy by to Timeline mělo začít.
CanFreeze	Získá hodnotu, která označuje, zda objekt lze změnit. (Zděděno od Freezable)
DecelerationRatio	Získá nebo nastaví hodnotu určující procento časové osy Duration strávené zpomalením průchodu času z jeho maximální míry na nulu.
DependencyObjectType	Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá to Dispatcher DispatcherObject je přidružena k. (Zděděno od DispatcherObject)
Duration	Získá nebo nastaví dobu, po kterou tato časová osa přehrává, nepočítá opakování.
FillBehavior	Získá nebo nastaví hodnotu, která určuje, jak Timeline se chová po dosažení konce aktivního období.
HasAnimatedProperties	Získá hodnotu, která označuje, zda jeden nebo více AnimationClock objektů je přidružena k některému z vlastností závislostí tohoto objektu. (Zděděno od Animatable)
IsFrozen	Získá hodnotu, která označuje, zda je objekt aktuálně upravitelný. (Zděděno od Freezable)
IsSealed	Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Name	Získá nebo nastaví název tohoto Timeline.
RepeatBehavior	Získá nebo nastaví opakující se chování této časové osy.
SpeedRatio	Získá nebo nastaví míru vzhledem k nadřazené hodnotě, ve které době postupuje pro tento Timelineobjekt .

Přidružené vlastnosti

DesiredFrameRate

Získá nebo nastaví požadovanou snímkovou frekvenci pro tuto časovou osu a její podřízené časové osy.

Metody

AllocateClock()	Vytvoří pro tento Timeline.Clock
ApplyAnimationClock(DependencyProperty, AnimationClock)	Použije na AnimationClock zadanou DependencyPropertyhodnotu . Pokud je vlastnost už animovaná, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Použije na AnimationClock zadanou DependencyPropertyhodnotu . Pokud je vlastnost už animovaná, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Použije animaci na zadaný objekt DependencyProperty. Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Použije animaci na zadaný objekt DependencyProperty. Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animovaná, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která má být vymazána, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
Clone()	Vytvoří upravitelný klon tohoto Timelineobjektu a vytvoří hluboké kopie hodnot tohoto objektu.
CloneCore(Freezable)	Vytvoří instanci klon (hloubkovou kopii) zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností. (Zděděno od Freezable)
CloneCurrentValue()	Vytvoří upravitelný klon tohoto Timeline objektu a vytvoří hluboké kopie aktuálních hodnot tohoto objektu.
CloneCurrentValueCore(Freezable)	Vytvoří instanci upravitelný klon (hloubkovou kopii) zadaného Freezable pomocí aktuálních hodnot vlastností. (Zděděno od Freezable)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosáhne vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
CreateClock()	Vytvoří nový ovládací prvek Clock z tohoto Timeline. Pokud se jedná Timeline o podřízené položky, vytvoří se strom hodin s tímto Timeline kořenem.
CreateClock(Boolean)	Vytvoří z tohoto Timeline nového Clock a určuje, zda je nový Clock říditelný. Pokud se jedná Timeline o podřízené položky, vytvoří se strom hodin s tímto Timeline kořenem.
CreateInstance()	Inicializuje novou instanci Freezable třídy . (Zděděno od Freezable)
CreateInstanceCore()	Při implementaci v odvozené třídě vytvoří novou instanci odvozené Freezable třídy. (Zděděno od Freezable)
Equals(Object)	Určuje, zda zadaný DependencyObject je ekvivalentní k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
Freeze()	Nastaví aktuální objekt jako neupravitelný a nastaví jeho IsFrozen vlastnost na `true`. (Zděděno od Freezable)
FreezeCore(Boolean)	Nastaví tuto Timeline hodnotu jako neupravovatelnou nebo určuje, zda ji nelze změnit.
GetAnimationBaseValue(DependencyProperty)	Vrátí ne animovanou hodnotu zadané DependencyPropertyhodnoty . (Zděděno od Animatable)
GetAsFrozen()	Vytvoří zamrzlou kopii objektu Freezables použitím základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, jsou všechny ukotvené dílčí objekty zkopírovány odkazem. (Zděděno od Freezable)
GetAsFrozenCore(Freezable)	Vytvoří tuto instanci klon zadaného Timeline objektu.
GetCurrentValueAsFrozen()	Vytvoří zamrzlou kopii objektu Freezable s použitím aktuálních hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, jsou všechny ukotvené dílčí objekty zkopírovány odkazem. (Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Vytvoří tuto instanci zablokovaný klon zadaného Timelineobjektu . Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty ano.
GetDesiredFrameRate(Timeline)	Získá požadovanou snímkovou frekvenci zadaného Timelineobjektu .
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetNaturalDuration(Clock)	Vrátí délku jedné iterace tohoto Timelinetypu .
GetNaturalDurationCore(Clock)	Vrátí délku jedné iterace tohoto Timelinetypu . Tato metoda poskytuje implementaci pro GetNaturalDuration(Clock).
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnChanged()	Volána při změně aktuálního Freezable objektu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zajišťuje, že jsou vytvořeny vhodné ukazatele kontextu pro DependencyObjectType datový člen, který byl právě nastaven. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Tento člen podporuje infrastrukturu Windows Presentation Foundation (WPF) a není určen k použití přímo z vašeho kódu. (Zděděno od Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Přepíše implementaci DependencyObject tak, OnPropertyChanged(DependencyPropertyChangedEventArgs) aby také vyvolala všechny Changed obslužné rutiny v reakci na měnící se vlastnost závislosti typu Freezable. (Zděděno od Freezable)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
ReadPreamble()	Zajišťuje, že Freezable se k souboru přistupuje z platného vlákna. Dědíci Freezable musí tuto metodu volat na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnosti závislostí. (Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)	Nastaví požadovanou snímkovou frekvenci zadané Timelinehodnoty .
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
WritePostscript()	Changed Vyvolá událost pro Freezable a vyvolá jeho OnChanged() metodu. Třídy odvozené z Freezable by měly tuto metodu volat na konci jakéhokoli rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislosti. (Zděděno od Freezable)
WritePreamble()	Ověřuje, že Freezable objekt není zamrznutý a že se k němu přistupuje z platného kontextu podprocesů. Freezable Dědiče by tuto metodu měli volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnosti závislostí. (Zděděno od Freezable)

Událost

Changed	Vyvolá se při změně objektu Freezable nebo objektu, který obsahuje. (Zděděno od Freezable)
Completed	Vyvolá se po úplném dokončení přehrávání této časové osy: už nezajde do aktivního období.
CurrentGlobalSpeedInvalidated	Vyvolá se, když se změní rychlost, kterou čas postupuje pro hodiny časové osy.
CurrentStateInvalidated	Vyvolá se při CurrentState aktualizaci vlastnosti časové osy Clock .
CurrentTimeInvalidated	Vyvolá se při CurrentTime aktualizaci vlastnosti časové osy Clock .
RemoveRequested	Vyvolá se při odebrání hodin vytvořených pro tuto časovou osu nebo některé z jejích nadřazených časových os.

Platí pro

Viz také

Ukázka chování časování animace