Timeline Třída

Definice

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
Odvozené
Atributy

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 DispatcherDispatcherObject 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é