SingleAnimation Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media.Animation

Zestaw:: PresentationCore.dll

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.

Animuje wartość Single właściwości między dwiema wartościami docelowymi przy użyciu interpolacji liniowej w określonym Durationobiekcie .

public ref class SingleAnimation : System::Windows::Media::Animation::SingleAnimationBase

public class SingleAnimation : System.Windows.Media.Animation.SingleAnimationBase

type SingleAnimation = class
    inherit SingleAnimationBase

Public Class SingleAnimation
Inherits SingleAnimationBase

Dziedziczenie: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

SingleAnimationBase
SingleAnimation

Uwagi

Animacja aktualizuje wartość właściwości w danym okresie. Efekt animacji może być subtelny, taki jak przesunięcie Shape kilku pikseli w lewo i w prawo lub dramatyczne, na przykład powiększanie obiektu do 200 razy jego oryginalny rozmiar podczas obracania go i zmieniania jego koloru. Aby utworzyć animację w Windows Presentation Foundation (WPF), należy skojarzyć animację z wartością właściwości obiektu.

Wartości docelowe

Klasa SingleAnimation tworzy przejście między dwiema wartościami docelowymi. Aby ustawić wartości docelowe, użyj jej Fromwłaściwości , Toi By . Poniższa tabela zawiera podsumowanie sposobu, w jaki Fromwłaściwości , Toi By mogą być używane razem lub oddzielnie w celu określenia wartości docelowych animacji.

Określone właściwości	Wynikowe działanie
From	Animacja przechodzi od wartości określonej przez From właściwość do wartości podstawowej właściwości animowanej lub do wartości wyjściowej poprzedniej animacji, w zależności od konfiguracji poprzedniej animacji.
From i To	Animacja przechodzi z wartości określonej przez From właściwość do wartości określonej przez To właściwość .
From i By	Animacja postępuje z wartości określonej przez From właściwość do wartości określonej przez sumę From właściwości i By .
To	Animacja przechodzi z wartości podstawowej animowanej właściwości lub wartości wyjściowej poprzedniej animacji do wartości określonej przez To właściwość .
By	Animacja przechodzi od wartości podstawowej właściwości animowanej lub wartości wyjściowej poprzedniej animacji do sumy tej wartości i wartości określonej przez By właściwość.

Uwaga

Jeśli ustawisz właściwości To i By , To właściwość ma pierwszeństwo, a By właściwość zostanie zignorowana.

Aby użyć innych metod interpolacji lub animować między więcej niż dwiema wartościami docelowymi, użyj SingleAnimationUsingKeyFrames obiektu .

Aby uzyskać informacje na temat stosowania wielu animacji do jednej właściwości, zobacz Omówienie animacji klatek kluczowych.

Funkcje z możliwością zamrażania

SingleAnimation Ponieważ klasa dziedziczy z Freezableklasy , SingleAnimation obiekty uzyskują kilka specjalnych funkcji, które obejmują następujące elementy: można je zadeklarować jako zasoby, współdzielone między wieloma obiektami, wykonane tylko do odczytu, aby zwiększyć wydajność, sklonować i zapewnić bezpieczeństwo wątków. Aby uzyskać więcej informacji na temat różnych funkcji udostępnianych przez Freezable obiekty, zobacz Omówienie obiektów zamrażalnych.

Konstruktory

SingleAnimation()	Inicjuje nowe wystąpienie klasy SingleAnimation.
SingleAnimation(Single, Duration)	Inicjuje SingleAnimation nowe wystąpienie klasy, która animuje określoną wartość w określonym czasie trwania. Wartość początkowa animacji to podstawowa wartość właściwości animowanej lub danych wyjściowych z innej animacji.
SingleAnimation(Single, Duration, FillBehavior)	Inicjuje SingleAnimation nowe wystąpienie klasy, która animuje określoną wartość w określonym czasie trwania i ma określone zachowanie wypełnienia. Wartość początkowa animacji to podstawowa wartość właściwości animowanej lub danych wyjściowych z innej animacji.
SingleAnimation(Single, Single, Duration)	Inicjuje SingleAnimation nowe wystąpienie klasy, która animuje od określonej wartości początkowej do określonej wartości docelowej w określonym czasie trwania.
SingleAnimation(Single, Single, Duration, FillBehavior)	Inicjuje SingleAnimation nowe wystąpienie klasy, która animuje z określonej wartości początkowej do określonej wartości docelowej w określonym czasie trwania i ma określone zachowanie wypełnienia.

Pola

ByProperty	Identyfikuje By właściwość zależności.
EasingFunctionProperty	Identyfikuje EasingFunction właściwość zależności.
FromProperty	Identyfikuje From właściwość zależności.
ToProperty	Identyfikuje To właściwość zależności.

Właściwości

AccelerationRatio	Pobiera lub ustawia wartość określającą procent czasu spędzonego na osi czasu Duration przyspieszając przejście czasu 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)
By	Pobiera lub ustawia łączną kwotę, według której animacja zmienia jego wartość początkową.
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. (Odziedziczone po Timeline)
DependencyObjectType	DependencyObjectType Pobiera opakowujący 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ń. (Odziedziczone po Timeline)
EasingFunction	Pobiera lub ustawia funkcję złagodzenia zastosowaną do tej animacji.
FillBehavior	Pobiera lub ustawia wartość, która określa, jak Timeline zachowuje się po osiągnięciu końca aktywnego okresu. (Odziedziczone po Timeline)
From	Pobiera lub ustawia wartość początkową animacji.
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)
IsAdditive	Pobiera lub ustawia wartość wskazującą, czy bieżąca wartość właściwości docelowej powinna zostać dodana do wartości początkowej tej animacji.
IsCumulative	Pobiera lub ustawia wartość określającą, czy wartość animacji gromadzi się po powtórzeniu.
IsDestinationDefault	Pobiera wartość wskazującą, czy ta animacja używa parametru defaultDestinationValueGetCurrentValue(Object, Object, AnimationClock) metody jako wartości docelowej. (Odziedziczone po AnimationTimeline)
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	Pobiera typ wartości generowanej przez tę animację. (Odziedziczone po SingleAnimationBase)
To	Pobiera lub ustawia wartość końcową animacji.

Metody

AllocateClock()	Tworzy element Clock dla tego AnimationTimelinepliku . (Odziedziczone po AnimationTimeline)
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 zostanie użyte 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 DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego SingleAnimationobiektu , 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)	Sprawia, że wystąpienie jest klonem (kopią głęboką) określonej Freezable wartości właściwości 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 modyfikowalny klon (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable)
CoerceValue(DependencyProperty)	Coerce 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. (Odziedziczone po 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, drzewo zegarów jest tworzone z tym Timeline jako element główny. (Odziedziczone po Timeline)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Tworzy nowe wystąpienie klasy PointAnimationUsingKeyFrames.
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 `true`. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że jest to Timeline niemodyfikowalne lub określa, czy można go niemodyfikować. (Odziedziczone po Timeline)
GetAnimationBaseValue(DependencyProperty)	Zwraca wartość nie animowaną 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. (Odziedziczone po SingleAnimationBase)
GetCurrentValue(Single, Single, AnimationClock)	Pobiera bieżącą wartość animacji. (Odziedziczone po SingleAnimationBase)
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ą. (Odziedziczone po Timeline)
GetCurrentValueCore(Single, Single, AnimationClock)	Oblicza wartość reprezentującą bieżącą wartość właściwości, która jest animowana zgodnie z wartością SingleAnimation.
GetHashCode()	Pobiera kod skrótu dla tego pliku 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 w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetNaturalDuration(Clock)	Zwraca długość pojedynczej iteracji tego Timelineelementu . (Odziedziczone po Timeline)
GetNaturalDurationCore(Clock)	Zwraca długość pojedynczej iteracji tego AnimationTimelineelementu . (Odziedziczone po AnimationTimeline)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu 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 po zmodyfikowaniu bieżącego Freezable obiektu. (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)
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 OnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur 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()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable 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 zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego 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ślona 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 Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu 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 do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, 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. (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, gdy CurrentState właściwość osi czasu Clock jest aktualizowana. (Odziedziczone po Timeline)
CurrentTimeInvalidated	Występuje, gdy CurrentTime właściwość osi czasu Clock jest aktualizowana. (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)

Dotyczy

Udostępnij za pośrednictwem