AnimationTimeline Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje segment czasu, w którym są generowane wartości wyjściowe. Te wartości są używane do animowania właściwości docelowej.
public ref class AnimationTimeline abstract : System::Windows::Media::Animation::Timelinepublic abstract class AnimationTimeline : System.Windows.Media.Animation.Timelinetype AnimationTimeline = class
inherit TimelinePublic MustInherit Class AnimationTimeline
Inherits Timeline- Dziedziczenie
- Pochodne
Uwagi
Obiekt AnimationTimeline jest typem Timeline obiektu, który generuje wartości wyjściowe na podstawie postępu chronometrażu. Wszystkie typy animacji dziedziczą z AnimationTimelineelementu .
Funkcje zamrażalne: Ponieważ dziedziczy ona z Freezable klasy, AnimationTimeline klasa zapewnia kilka specjalnych funkcji: AnimationTimeline obiekty można zadeklarować jako zasoby, współdzielone między wieloma obiektami, wykonane tylko do odczytu w celu zwiększenia wydajności, sklonowania i bezpiecznego wątku. Aby uzyskać więcej informacji na temat różnych funkcji udostępnianych przez Freezable obiekty, zobacz Omówienie obiektów z możliwością zamrażania.
Notatki dotyczące implementowania
Aby utworzyć animację niestandardową, przesłoń lub zaimplementuj następujące elementy członkowskie:
CreateInstanceCore() — Jeśli nowa klasa jest konkretna, należy zastąpić CreateInstanceCore() , aby zwrócić nowe wystąpienie klasy.
GetCurrentValue(Object, Object, AnimationClock) — Zastąpij tę metodę, aby zwrócić bieżącą wartość animacji. Przyjmuje trzy parametry: domyślną wartość źródła, domyślną wartość docelową AnimationClocki . Użyj elementu , AnimationClock aby uzyskać bieżący czas lub postęp animacji. Możesz wybrać, czy mają być używane domyślne wartości źródła i miejsca docelowego.
IsDestinationDefault — Zastąpij tę właściwość, aby wskazać, czy animacja używa domyślnej wartości docelowej określonej przez metodę GetCurrentValue(Object, Object, AnimationClock) .
TargetPropertyType — Zastąpij tę właściwość, aby wskazać Type dane wyjściowe generowane przez animację.
Jeśli klasa nie używa właściwości zależności do przechowywania danych lub wymaga dodatkowej inicjalizacji po utworzeniu, może być konieczne zastąpienie dodatkowych metod; Aby uzyskać więcej informacji, zobacz Omówienie obiektów zamrażalnych .
Aby uzyskać więcej informacji na temat tworzenia animacji niestandardowych, zobacz Omówienie animacji niestandardowych.
Konstruktory
| Nazwa | Opis |
|---|---|
| AnimationTimeline() |
Inicjuje nowe wystąpienie klasy AnimationTimeline. |
Pola
| Nazwa | Opis |
|---|---|
| IsAdditiveProperty |
Identyfikuje właściwość zależności IsAdditive. |
| IsCumulativeProperty |
Identyfikuje właściwość zależności IsCumulative. |
Właściwości
| Nazwa | Opis |
|---|---|
| AccelerationRatio |
Pobiera lub ustawia wartość określającą wartość procentową czasu spędzonego na osi czasu Duration , przyspieszając czas od zera do maksymalnej stawki. (Odziedziczone po Timeline) |
| AutoReverse |
Pobiera lub ustawia wartość wskazującą, czy oś czasu jest odtwarzana odwrotnie po zakończeniu iteracji do przodu. (Odziedziczone po Timeline) |
| BeginTime |
Pobiera lub ustawia czas, w którym to Timeline powinno się rozpocząć. (Odziedziczone po Timeline) |
| CanFreeze |
Pobiera wartość wskazującą, czy obiekt może być niezmodyfikowalny. (Odziedziczone po Freezable) |
| DecelerationRatio |
Pobiera lub ustawia wartość określającą wartość procentową czasu spędzonego Duration w deceleracji czasu z maksymalnej szybkości do zera. (Odziedziczone po Timeline) |
| DependencyObjectType |
Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject) |
| Dispatcher |
Pobiera elementDispatcher, z który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject) |
| Duration |
Pobiera lub ustawia czas, dla którego ta oś czasu jest odtwarzana, a nie zlicza powtórzeń. (Odziedziczone po Timeline) |
| FillBehavior |
Pobiera lub ustawia wartość, która określa, jak Timeline zachowuje się po osiągnięciu końca jego aktywnego okresu. (Odziedziczone po Timeline) |
| HasAnimatedProperties |
Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable) |
| IsDestinationDefault |
Pobiera wartość wskazującą, czy ta animacja używa parametru GetCurrentValue(Object, Object, AnimationClock) metody jako wartości docelowej. |
| IsFrozen |
Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable) |
| IsSealed |
Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject) |
| Name |
Pobiera lub ustawia nazwę tego Timelineelementu . (Odziedziczone po Timeline) |
| RepeatBehavior |
Pobiera lub ustawia powtarzające się zachowanie tej osi czasu. (Odziedziczone po Timeline) |
| SpeedRatio |
Pobiera lub ustawia stawkę względem jej elementu nadrzędnego, w którym czasie postępuje dla tego Timelineelementu . (Odziedziczone po Timeline) |
| TargetPropertyType |
Po zastąpieniu w klasie pochodnej pobiera Type właściwość , która może być animowana. |
Metody
| Nazwa | Opis |
|---|---|
| AllocateClock() |
Clock Tworzy element dla tego elementu AnimationTimeline. |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable) |
| CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
| ClearValue(DependencyProperty) |
Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject) |
| Clone() |
Tworzy modyfikowalny klon tego AnimationTimelineobiektu , tworząc głębokie kopie wartości tego obiektu. Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie animacje ani ich bieżące wartości. |
| CloneCore(Freezable) |
Tworzy wystąpienie klona (kopii głębokiej) określonego Freezable przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable) |
| CloneCurrentValue() |
Tworzy modyfikowalny klon tego Timeline obiektu, tworząc głębokie kopie bieżących wartości tego obiektu. (Odziedziczone po Timeline) |
| CloneCurrentValueCore(Freezable) |
Sprawia, że wystąpienie jest modyfikowalnym klonem (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable) |
| CoerceValue(DependencyProperty) |
Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject) |
| CreateClock() |
Tworzy nowy AnimationClock element na podstawie tego elementu AnimationTimeline. |
| CreateClock(Boolean) |
Tworzy nowy Clock element z tego Timeline elementu i określa, czy nowy Clock jest możliwy do kontrolowania. Jeśli ma to Timeline elementy podrzędne, zostanie utworzone drzewo zegarów z tym Timeline jako element główny. (Odziedziczone po Timeline) |
| CreateInstance() |
Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable) |
| CreateInstanceCore() |
Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable) |
| Equals(Object) |
Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject) |
| Freeze() |
Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na |
| FreezeCore(Boolean) |
Sprawia, że jest to Timeline niezmodyfikowalne lub określa, czy można go cofnąć. (Odziedziczone po Timeline) |
| GetAnimationBaseValue(DependencyProperty) |
Zwraca nie animowaną wartość określonego DependencyPropertyelementu . (Odziedziczone po Animatable) |
| GetAsFrozen() |
Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
| GetAsFrozenCore(Freezable) |
Sprawia, że to wystąpienie jest klonem określonego Timeline obiektu. (Odziedziczone po Timeline) |
| GetCurrentValue(Object, Object, AnimationClock) |
Pobiera bieżącą wartość animacji. |
| GetCurrentValueAsFrozen() |
Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Powoduje, że to wystąpienie jest zamrożonym klonem określonego Timelineelementu . Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są. (Odziedziczone po Timeline) |
| GetHashCode() |
Pobiera kod skrótu dla tego elementu DependencyObject. (Odziedziczone po DependencyObject) |
| GetLocalValueEnumerator() |
Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości na tym DependencyObjectobiekcie . (Odziedziczone po DependencyObject) |
| GetNaturalDuration(Clock) |
Zwraca długość pojedynczej iteracji tego elementu Timeline. (Odziedziczone po Timeline) |
| GetNaturalDurationCore(Clock) |
Zwraca długość pojedynczej iteracji tego elementu AnimationTimeline. |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| GetValue(DependencyProperty) |
Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Ponownie oblicza obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| OnChanged() |
Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie ma być używany bezpośrednio z kodu. (Odziedziczone po Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (Odziedziczone po Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Zastępuje implementację DependencyObject metody OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą właściwość zależności typu Freezable. (Odziedziczone po Freezable) |
| ReadLocalValue(DependencyProperty) |
Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject) |
| ReadPreamble() |
Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedziczy Freezable muszą wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Ustawia wartość właściwości zależności bez zmieniania źródła wartości. (Odziedziczone po DependencyObject) |
| SetValue(DependencyProperty, Object) |
Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
| WritePostscript() |
Changed Wywołuje zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable klasy powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable) |
| WritePreamble() |
Sprawdza, czy Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp z prawidłowego kontekstu wątkowego. Freezable dziedziczy powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje dane członkom, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
Zdarzenia
| Nazwa | Opis |
|---|---|
| Changed |
Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable) |
| Completed |
Występuje po całkowitym zakończeniu odtwarzania tej osi czasu: nie będzie już wprowadzać aktywnego okresu. (Odziedziczone po Timeline) |
| CurrentGlobalSpeedInvalidated |
Występuje, gdy częstotliwość, w której następuje postęp zegara osi czasu zmienia się. (Odziedziczone po Timeline) |
| CurrentStateInvalidated |
Występuje po CurrentState zaktualizowaniu właściwości osi czasu Clock . (Odziedziczone po Timeline) |
| CurrentTimeInvalidated |
Występuje po CurrentTime zaktualizowaniu właściwości osi czasu Clock . (Odziedziczone po Timeline) |
| RemoveRequested |
Występuje po usunięciu zegara utworzonego dla tej osi czasu lub jednej z jej nadrzędnych osi czasu. (Odziedziczone po Timeline) |
