Timeline Třída

Definice

Definuje segment času.

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 segment času. Poskytuje vlastnosti, které umožňují určit délku tohoto segmentu, kdy se má spustit, kolikrát se bude opakovat, jak rychle se v tomto segmentu postupuje, a další.

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

  • Animace: Typ AnimationTimeline časové osy, která vytváří výstupní hodnoty. Když přidružíte animaci k vlastnosti, animace při přehrávání aktualizuje hodnotu vlastnosti 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í naleznete v přehledu technik animace vlastností.

  • MediaTimelines: Typ MediaTimeline časové osy, která řídí přehrávání multimediálního souboru.

  • ParallelTimelines: 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 určené pro č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 přehledu animací. Úvod k funkcím časování časových os najdete v přehledu 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 data svázaná nebo animované časové osy nechovají stejně jako jiné vázané nebo animované objekty. Pokud chcete porozumět jejich chování, pomůže vám pochopit, co znamená aktivovat časovou osu.

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

Aby časová osa odrážela změny datové vazby 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 je časová osa nebo patří do ní Storyboard, můžete ji provést tak, že změny znovu použijete pomocí BeginStoryboard Begin nebo metody. To má vedlejší vliv také na restartování animace. V kódu můžete metodu Seek použít k přechodu scénáře zpět na předchozí pozici.

  • Pokud jste použili animaci přímo na vlastnost pomocí BeginAnimation metody, zavolejte BeginAnimation metodu znovu a předejte ji animaci, která byla upravena.

  • Pokud pracujete přímo na úrovni hodin, vytvořte a použijte novou sadu hodin a použijte je k nahrazení předchozí sady generovaný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 probíhat pouze v případě, že je k ní přidružena obslužná rutina události nebo (v případě AnimationClock objektu), která je přidružena k vlastnosti. Z tohoto důvodu (a další) 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 BeginTime.

Timeline(Nullable<TimeSpan>, Duration)

Inicializuje novou instanci Timeline třídy se zadaným BeginTime a Duration.

Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)

Inicializuje novou instanci Timeline třídy se zadaným BeginTime, Durationa RepeatBehavior.

Pole

AccelerationRatioProperty

Identifikuje AccelerationRatio vlastnost závislostí.

AutoReverseProperty

Identifikuje AutoReverse vlastnost závislostí.

BeginTimeProperty

Identifikuje BeginTime vlastnost závislostí.

DecelerationRatioProperty

Identifikuje vlastnost DecelerationRatio závislostí.

DesiredFrameRateProperty

Identifikuje připojenou DesiredFrameRate vlastnost.

DurationProperty

Identifikuje Duration vlastnost závislostí.

FillBehaviorProperty

Identifikuje FillBehavior vlastnost závislostí.

NameProperty

Identifikuje Name vlastnost závislostí.

RepeatBehaviorProperty

Identifikuje RepeatBehavior vlastnost závislostí.

SpeedRatioProperty

Identifikuje vlastnost SpeedRatio závislostí.

Vlastnosti

AccelerationRatio

Získá nebo nastaví hodnotu určující procento časové osy Duration strávené urychlením průchodu času od nuly do maximální míry.

AutoReverse

Získá nebo nastaví hodnotu, která označuje, jestli se časová osa přehraje obráceně po dokončení iterace vpřed.

BeginTime

Získá nebo nastaví čas, ve kterém má začít Timeline .

CanFreeze

Získá hodnotu, která označuje, zda objekt lze upravit.

(Zděděno od Freezable)
DecelerationRatio

Získá nebo nastaví hodnotu určující procento časové osy Duration strávené decelerací průchodu času od maximální sazby na nulu.

DependencyObjectType

DependencyObjectType Získá ten, který zabalí typ CLR této instance.

(Zděděno od DependencyObject)
Dispatcher

Získá to DispatcherObject je přidruženoDispatcher.

(Zděděno od DispatcherObject)
Duration

Získá nebo nastaví dobu, po kterou se tato časová osa přehraje, a ne počítá opakování.

FillBehavior

Získá nebo nastaví hodnotu, která určuje, jak se Timeline 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žen k některé z vlastností závislostí tohoto objektu.

(Zděděno od Animatable)
IsFrozen

Získá hodnotu, která označuje, zda objekt je aktuálně upravitelný.

(Zděděno od Freezable)
IsSealed

Získá hodnotu, která označuje, zda je tato instance aktuálně 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í sazbu vzhledem k nadřazené hodnotě, v níž pro tento čas Timelinepostupuje .

Přidružené vlastnosti

DesiredFrameRate

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

Metody

AllocateClock()

Vytvoří pro to Timeline.Clock

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock Použije u zadaného DependencyPropertyparametru . Pokud je vlastnost již animované, použije se SnapshotAndReplace chování předání.

(Zděděno od Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock Použije u zadaného DependencyPropertyparametru . Pokud je vlastnost již animované, použije se zadaný HandoffBehavior parametr.

(Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Použije animaci u zadaného DependencyPropertyobjektu . 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 u zadaného DependencyPropertyobjektu . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, použije se zadaný HandoffBehavior parametr.

(Zděděno od Animatable)
CheckAccess()

Určuje, zda má volající vlákno přístup k tomuto DispatcherObject.

(Zděděno od DispatcherObject)
ClearValue(DependencyProperty)

Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, 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 objektu Timelinea vytvoří hluboké kopie hodnot tohoto objektu.

CloneCore(Freezable)

Vytvoří instanci klonem (hloubkovou kopií) 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 modifikovatelný 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. To se provádí vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject.

(Zděděno od DependencyObject)
CreateClock()

Vytvoří nový ovládací prvek Clock z tohoto souboru Timeline. Pokud se jedná Timeline o podřízené položky, vytvoří se strom hodin s tímto Timeline názvem jako kořen.

CreateClock(Boolean)

Vytvoří z tohoto objektu Timeline novou Clock a určuje, zda je nový Clock ovládací prvek. Pokud se jedná Timeline o podřízené položky, vytvoří se strom hodin s tímto Timeline názvem jako kořen.

CreateInstance()

Inicializuje novou instanci Freezable třídy.

(Zděděno od Freezable)
CreateInstanceCore()

Při implementaci v odvozené třídě vytvoří novou instanci Freezable odvozené třídy.

(Zděděno od Freezable)
Equals(Object)

Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject.

(Zděděno od DependencyObject)
Freeze()

Nastaví aktuální objekt nemodifikovatelný a nastaví jeho IsFrozen vlastnost na true.

(Zděděno od Freezable)
FreezeCore(Boolean)

Znemožní tento Timeline modifikovatelný nebo určuje, zda je možné ho upravit.

GetAnimationBaseValue(DependencyProperty)

Vrátí ne animovanou hodnotu zadané DependencyPropertyhodnoty .

(Zděděno od Animatable)
GetAsFrozen()

Vytvoří zmrazenou kopii Freezablevlastnosti , pomocí základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že je kopie zmrazená, všechny zmrazené dílčí objekty se kopírují odkazem.

(Zděděno od Freezable)
GetAsFrozenCore(Freezable)

Vytvoří tuto instanci jako klon zadaného Timeline objektu.

GetCurrentValueAsFrozen()

Vytvoří ukotvenou kopii pomocí aktuálních Freezable hodnot vlastností. Vzhledem k tomu, že je kopie zmrazená, všechny ukotvené dílčí objekty se zkopírují odkazem.

(Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Vytvoří tuto instanci zmrazeným klonem zadaného Timeline. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty jsou.

GetDesiredFrameRate(Timeline)

Získá požadovanou frekvenci snímků zadaného Timeline.

GetHashCode()

Získá hash kód pro tento DependencyObject.

(Zděděno od DependencyObject)
GetLocalValueEnumerator()

Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislostí mají místně nastavené hodnoty na tomto DependencyObject.

(Zděděno od DependencyObject)
GetNaturalDuration(Clock)

Vrátí délku jedné iterace této Timeline.

GetNaturalDurationCore(Clock)

Vrátí délku jedné iterace této Timeline. Tato metoda poskytuje implementaci pro GetNaturalDuration(Clock).

GetType()

Type Získá aktuální instanci.

(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ří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
OnChanged()

Volá se při změně aktuálního Freezable objektu.

(Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zajišťuje, aby se pro DependencyObjectType datový člen, který právě byl nastaven, vytvořily příslušné kontextové ukazatele.

(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)

DependencyObject Přepíše implementaciOnPropertyChanged(DependencyPropertyChangedEventArgs), která také vyvolá všechny Changed obslužné rutiny v reakci na změnu vlastnosti 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 se k němu Freezable přistupuje z platného vlákna. Dědiče této metody musí volat tuto metodu na začátku libovolného Freezable rozhraní API, které čte datové členy, které nejsou vlastnostmi závislostí.

(Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)

Nastaví hodnotu vlastnosti závislosti beze změny zdroje hodnot.

(Zděděno od DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)

Nastaví požadovanou frekvenci snímků zadaného Timeline.

SetValue(DependencyProperty, Object)

Nastaví místní hodnotu vlastnosti závislosti určenou jeho 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ávislostí.

(Zděděno od DependencyObject)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
VerifyAccess()

Vynucuje, aby volající vlákno má k tomuto DispatcherObjectpřístupu přístup .

(Zděděno od DispatcherObject)
WritePostscript()

Changed Vyvolá událost pro a Freezable vyvolá její OnChanged() metodu. Třídy odvozené z Freezable by měly volat tuto metodu na konci jakéhokoli rozhraní API, který upravuje členy třídy, které nejsou uloženy jako vlastnosti závislostí.

(Zděděno od Freezable)
WritePreamble()

Ověří, že Freezable není ukotvený a že k němu přistupujete z platného kontextu vlákna. Freezable dědiče by tuto metodu měli volat na začátku libovolného rozhraní API, které zapisuje do datových členů, které nejsou vlastnostmi závislostí.

(Zděděno od Freezable)

událost

Changed

Nastane při změně objektu Freezable nebo objektu, který obsahuje.

(Zděděno od Freezable)
Completed

Nastane, když tato časová osa dokončí přehrávání: už nebude zadávat aktivní období.

CurrentGlobalSpeedInvalidated

Nastane, když se rychlost, po kterou se pro hodiny časové osy mění.

CurrentStateInvalidated

Nastane při CurrentState aktualizaci vlastnosti časové osy Clock .

CurrentTimeInvalidated

Nastane při CurrentTime aktualizaci vlastnosti časové osy Clock .

RemoveRequested

Nastane při odebrání hodin vytvořených pro tuto časovou osu nebo jedné z nadřazených časových os.

Platí pro

Viz také