Timeline 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.
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
- Dziedziczenie
- Pochodne
- Atrybuty
Uwagi
Oś czasu reprezentuje segment czasu. Udostępnia właściwości, które umożliwiają określenie długości tego segmentu, kiedy ma się rozpocząć, ile razy będzie powtarzać się, jak szybko postępuje w tym segmencie i nie tylko.
Klasy dziedziczone z klasy osi czasu zapewniają dodatkowe funkcje, takie jak animacja i odtwarzanie multimediów. Poniżej przedstawiono przykłady różnych typów dostępnych wyspecjalizowanych osi czasu.
Animacje: typ AnimationTimeline osi czasu, który generuje wartości wyjściowe. Po skojarzeniu animacji z właściwością animacja aktualizuje wartość właściwości podczas jej odtwarzanie, a tym samym "animowanie". Aby zapoznać się z wprowadzeniem do animacji, zobacz Omówienie animacji. Aby uzyskać informacje o różnych sposobach stosowania animacji, zobacz Omówienie technik animacji właściwości.
MediaTimelines: typ MediaTimeline osi czasu, który kontroluje odtwarzanie pliku multimedialnego.
ParallelTimelines: typ ParallelTimeline osi czasu, który grupuje inne osie czasu.
Scenorysy: typ Storyboard specjalny ParallelTimeline , który udostępnia informacje o obiektach i właściwościach przeznaczonych dla osi czasu, które zawiera. Aby uzyskać więcej informacji na temat Storyboard obiektów, zobacz Storyboards Overview (Omówienie scenorysów).
Aby uzyskać więcej informacji na temat korzystania z osi czasu, zobacz Omówienie animacji. Aby zapoznać się z wprowadzeniem do funkcji chronometrażu osi czasu, zobacz Omówienie zachowania chronometrażu.
Powiązanie danych i animowanie osi czasu
Większość właściwości osi czasu może być powiązana lub animowana; jednak ze względu na sposób działania systemu chronometrażu dane powiązane lub animowane osie czasu nie zachowują się jak inne powiązane lub animowane obiekty. Aby zrozumieć ich zachowanie, warto zrozumieć, co to znaczy aktywować oś czasu.
Po zastosowaniu osi czasu kopie są tworzone z osi czasu i osi czasu podrzędnych. Te kopie są zamrożone (wykonane tylko do odczytu) i Clock tworzone na ich podstawie obiekty. To te zegary wykonują rzeczywistą pracę animowania docelowych właściwości. Jeśli oś czasu była powiązana lub animowana, utworzono migawkę jej bieżących wartości podczas tworzenia zegara. Mimo że oryginalna oś czasu może nadal ulec zmianie, jego zegar nie jest.
Aby oś czasu odzwierciedlała zmiany powiązania danych lub animacji, jego zegar musi zostać ponownie wygenerowany. Zegary nie są generowane automatycznie. Poniżej przedstawiono kilka sposobów stosowania zmian osi czasu:
Jeśli oś czasu jest lub należy do Storyboardelementu , możesz wprowadzić zmiany, stosując ponownie scenorys przy użyciu metody BeginStoryboard lub Begin . Ma to również efekt uboczny ponownego uruchomienia animacji. W kodzie możesz użyć Seek metody , aby przejść do scenorysu z powrotem do poprzedniej pozycji.
Jeśli animacja została zastosowana bezpośrednio do właściwości przy użyciu BeginAnimation metody , wywołaj BeginAnimation metodę ponownie i przekaż ją do zmodyfikowanej animacji.
Jeśli pracujesz bezpośrednio na poziomie zegara, utwórz i zastosuj nowy zestaw zegarów i użyj ich do zastąpienia poprzedniego zestawu wygenerowanych zegarów.
Aby zapoznać się z przykładem animacji powiązanej z danymi, zobacz Przykład animacji krzywej klucza .
Używanie osi czasu jako czasomierza
Zegar osi czasu będzie postępować tylko wtedy, gdy istnieje program obsługi zdarzeń skojarzony z nim lub (w przypadku AnimationClock obiektu) jest skojarzony z właściwością. Z tego powodu (i inne) nie zaleca się używania Timeline funkcji jako czasomierza.
Konstruktory
Timeline() |
Inicjuje nowe wystąpienie klasy Timeline. |
Timeline(Nullable<TimeSpan>) |
Inicjuje Timeline nowe wystąpienie klasy z określonym BeginTimeelementem . |
Timeline(Nullable<TimeSpan>, Duration) |
Inicjuje Timeline nowe wystąpienie klasy z określonymi BeginTime parametrami i Duration. |
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior) |
Inicjuje Timeline nowe wystąpienie klasy z określonymi BeginTimeparametrami , Durationi RepeatBehavior. |
Pola
AccelerationRatioProperty |
AccelerationRatio Identyfikuje właściwość zależności. |
AutoReverseProperty |
AutoReverse Identyfikuje właściwość zależności. |
BeginTimeProperty |
BeginTime Identyfikuje właściwość zależności. |
DecelerationRatioProperty |
Identyfikuje właściwość DecelerationRatio zależności. |
DesiredFrameRateProperty |
Identyfikuje dołączoną DesiredFrameRate właściwość. |
DurationProperty |
Duration Identyfikuje właściwość zależności. |
FillBehaviorProperty |
FillBehavior Identyfikuje właściwość zależności. |
NameProperty |
Name Identyfikuje właściwość zależności. |
RepeatBehaviorProperty |
RepeatBehavior Identyfikuje właściwość zależności. |
SpeedRatioProperty |
Identyfikuje właściwość SpeedRatio zależności. |
Właściwości
AccelerationRatio |
Pobiera lub ustawia wartość określającą wartość procentową Duration czasu poświęcanego na przyspieszenie upływu czasu od zera do maksymalnej stopy. |
AutoReverse |
Pobiera lub ustawia wartość wskazującą, czy oś czasu jest odtwarzana odwrotnie po zakończeniu iteracji do przodu. |
BeginTime |
Pobiera lub ustawia czas, w którym to Timeline powinno się rozpocząć. |
CanFreeze |
Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable) |
DecelerationRatio |
Pobiera lub ustawia wartość określającą wartość procentową czasu spędzonego na osi czasu Duration z upływem czasu od maksymalnej stawki do zera. |
DependencyObjectType |
Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject) |
Dispatcher |
Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject) |
Duration |
Pobiera lub ustawia czas, przez który ta oś czasu jest odtwarzana, nie licząc powtórzeń. |
FillBehavior |
Pobiera lub ustawia wartość, która określa, jak Timeline zachowuje się po osiągnięciu końca aktywnego okresu. |
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) |
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 . |
RepeatBehavior |
Pobiera lub ustawia powtarzające się zachowanie tej osi czasu. |
SpeedRatio |
Pobiera lub ustawia stawkę względem jej elementu nadrzędnego, w którym czasie postępuje dla tego Timelineelementu . |
Właściwości dołączone
DesiredFrameRate |
Pobiera lub ustawia żądaną częstotliwość klatek dla tej osi czasu i jej podrzędnych osi czasu. |
Metody
AllocateClock() | |
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) |
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) |
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) |
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) |
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 element DependencyPropertyKey. (Odziedziczone po DependencyObject) |
Clone() |
Tworzy modyfikowalny klon tego Timelineobiektu , tworząc głębokie kopie wartości tego obiektu. |
CloneCore(Freezable) |
Sprawia, że wystąpienie jest klonem (kopia głęboka) określonego Freezable obiektu przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable) |
CloneCurrentValue() |
Tworzy modyfikowalny klon tego Timeline obiektu, tworząc głębokie kopie bieżących wartości tego obiektu. |
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 element, który można Clock kontrolować na podstawie tego Timelineelementu . Jeśli ma to Timeline elementy podrzędne, drzewo zegarów jest tworzone z tym Timeline jako element główny. |
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, drzewo zegarów jest tworzone z tym Timeline jako element główny. |
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 niemodyfikowalny i ustawia jego IsFrozen właściwość na |
FreezeCore(Boolean) |
Sprawia, że jest to Timeline niemodyfikowalne lub określa, czy można go niemodyfikować. |
GetAnimationBaseValue(DependencyProperty) |
Zwraca nieimętowaną wartość określonego DependencyPropertyelementu . (Odziedziczone po Animatable) |
GetAsFrozen() |
Tworzy zamrożoną kopię Freezableobiektu przy użyciu podstawowych (nieimowanych) 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) |
GetAsFrozenCore(Freezable) |
Sprawia, że to wystąpienie jest klonem określonego Timeline obiektu. |
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 Timelineobiektu . Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są. |
GetDesiredFrameRate(Timeline) |
Pobiera żądaną szybkość klatek dla określonego Timelineelementu . |
GetHashCode() |
Pobiera kod skrótu dla tego DependencyObjectpliku . (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 dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject) |
GetNaturalDuration(Clock) |
Zwraca długość pojedynczej iteracji tego Timelineelementu . |
GetNaturalDurationCore(Clock) |
Zwraca długość pojedynczej iteracji tego Timelineelementu . Ta metoda zapewnia implementację dla programu GetNaturalDuration(Clock). |
GetType() |
Type Pobiera wartość 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 efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnChanged() |
Wywoływana, gdy bieżący Freezable obiekt jest modyfikowany. (Odziedziczone po Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Zapewnia, że dla elementu członkowskiego danych, który właśnie został ustawiony, są ustanawiane DependencyObjectType odpowiednie wskaźniki kontekstu. (Odziedziczone po Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Zastępuje implementację DependencyObject elementu OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą się 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() |
Zapewnia dostęp do obiektu Freezable z prawidłowego wątku. Dziedziczenie Freezable elementu musi 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 jej źródła wartości. (Odziedziczone po DependencyObject) |
SetDesiredFrameRate(Timeline, Nullable<Int32>) |
Ustawia żądaną częstotliwość klatek dla określonego Timelineelementu . |
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ść dla 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 klasy Freezable i wywołuje jego 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 element Freezable nie jest zamrożony i czy jest on uzyskiwany z prawidłowego kontekstu wątkowego. Freezable dziedziczenie powinno 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
Changed |
Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable) |
Completed |
Występuje, gdy ta oś czasu całkowicie zakończyła odtwarzanie: nie będzie już wprowadzać aktywnego okresu. |
CurrentGlobalSpeedInvalidated |
Występuje, gdy częstotliwość, w której następuje postęp zegara osi czasu zmienia się. |
CurrentStateInvalidated |
Występuje, gdy CurrentState właściwość osi czasu Clock jest aktualizowana. |
CurrentTimeInvalidated |
Występuje, gdy CurrentTime właściwość osi czasu Clock jest aktualizowana. |
RemoveRequested |
Występuje po usunięciu zegara utworzonego dla tej osi czasu lub jednej z jej nadrzędnych osi czasu. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla