ColorAnimation Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
public ref class ColorAnimation : System::Windows::Media::Animation::ColorAnimationBase
public class ColorAnimation : System.Windows.Media.Animation.ColorAnimationBase
type ColorAnimation = class
inherit ColorAnimationBase
Public Class ColorAnimation
Inherits ColorAnimationBase
- Arv
Kommentarer
En animering uppdaterar värdet för en egenskap under en viss tidsperiod. En animeringseffekt kan vara subtil, till exempel att flytta några Shape bildpunkter åt vänster och höger, eller dramatisk, till exempel att förstora ett objekt till 200 gånger dess ursprungliga storlek medan det snurrar och ändrar dess färg. Om du vill skapa en animering i Windows Presentation Foundation (WPF) associerar du en animering med ett objekts egenskapsvärde.
Målvärden
Klassen ColorAnimation skapar en övergång mellan två målvärden. Om du vill ange dess målvärden använder du egenskaperna From, Tooch By . I följande tabell sammanfattas hur Fromegenskaperna , Tooch By kan användas tillsammans eller separat för att fastställa målvärden för en animering.
| Angivna egenskaper | Resulterande beteende |
|---|---|
| From | Animeringen fortsätter från det värde som anges av From egenskapen till basvärdet för egenskapen som animeras eller till en tidigare animerings utdatavärde, beroende på hur den tidigare animeringen har konfigurerats. |
| From och To | Animeringen fortsätter från det värde som anges av From egenskapen till det värde som anges av To egenskapen. |
| From och By | Animeringen fortsätter från det värde som anges av From egenskapen till det värde som anges av summan av From egenskaperna och By . |
| To | Animeringen fortsätter från den animerade egenskapens basvärde eller en tidigare animerings utdatavärde till det värde som anges av To egenskapen. |
| By | Animeringen fortsätter från basvärdet för egenskapen som animerats eller en tidigare animerings utdatavärde till summan av det värdet och det värde som anges av By egenskapen. |
Note
Om du anger både To egenskaperna och By har egenskapen To företräde och egenskapen By ignoreras.
Om du vill använda andra interpoleringsmetoder eller animera mellan fler än två målvärden använder du ett ColorAnimationUsingKeyFrames objekt.
Information om hur du tillämpar flera animeringar på en enda egenskap finns iKey-Frame Översikt över animeringar.
Freezable-funktioner
ColorAnimation Eftersom klassen ärver från FreezableColorAnimation får objekt flera specialfunktioner, bland annat följande: de kan deklareras som resurser, delas mellan flera objekt, göras skrivskyddade för att förbättra prestanda, klonas och göras trådsäkra. Mer information om de olika funktionerna som tillhandahålls av Freezable objekt finns i Översikt över friserbara objekt.
Konstruktorer
| Name | Description |
|---|---|
| ColorAnimation() |
Initierar en ny instans av ColorAnimation klassen. |
| ColorAnimation(Color, Color, Duration, FillBehavior) |
Initierar en ny instans av ColorAnimation klassen som animerar från det angivna startvärdet till det angivna målvärdet under den angivna varaktigheten och har det angivna fyllningsbeteendet. |
| ColorAnimation(Color, Color, Duration) |
Initierar en ny instans av ColorAnimation klassen som animerar från det angivna startvärdet till det angivna målvärdet under den angivna varaktigheten. |
| ColorAnimation(Color, Duration, FillBehavior) |
Initierar en ny instans av ColorAnimation klassen som animerar till det angivna värdet under den angivna varaktigheten och har det angivna fyllningsbeteendet. Startvärdet för animeringen är basvärdet för egenskapen som animerats eller utdata från en annan animering. |
| ColorAnimation(Color, Duration) |
Initierar en ny instans av ColorAnimation klassen som animerar till det angivna värdet under den angivna varaktigheten. Startvärdet för animeringen är basvärdet för egenskapen som animerats eller utdata från en annan animering. |
Fält
| Name | Description |
|---|---|
| ByProperty |
Identifierar beroendeegenskapen By . |
| EasingFunctionProperty |
Identifierar beroendeegenskapen EasingFunction . |
| FromProperty |
Identifierar beroendeegenskapen From . |
| ToProperty |
Identifierar beroendeegenskapen To . |
Egenskaper
| Name | Description |
|---|---|
| AccelerationRatio |
Hämtar eller anger ett värde som anger procentandelen av tidslinjens tidsåtgång Duration från noll till dess maximala hastighet. (Ärvd från Timeline) |
| AutoReverse |
Hämtar eller anger ett värde som anger om tidslinjen spelas upp i omvänd ordning när den har slutfört en vidarebefordran iteration. (Ärvd från Timeline) |
| BeginTime |
Hämtar eller anger den tid då detta Timeline ska börja. (Ärvd från Timeline) |
| By |
Hämtar eller anger det totala belopp som animeringen ändrar sitt startvärde med. |
| CanFreeze |
Hämtar ett värde som anger om objektet kan göras ommodifierbart. (Ärvd från Freezable) |
| DecelerationRatio |
Hämtar eller anger ett värde som anger procentandelen av tidslinjens tidsåtgång Duration från den maximala hastigheten till noll. (Ärvd från Timeline) |
| DependencyObjectType |
DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen. (Ärvd från DependencyObject) |
| Dispatcher |
Hämtar det Dispatcher som DispatcherObject är associerat med. (Ärvd från DispatcherObject) |
| Duration |
Hämtar eller anger hur lång tid den här tidslinjen ska spelas upp, utan att räkna upprepningar. (Ärvd från Timeline) |
| EasingFunction |
Hämtar eller anger den lättnadsfunktion som tillämpas på den här animeringen. |
| FillBehavior |
Hämtar eller anger ett värde som anger hur den Timeline beter sig när den når slutet av den aktiva perioden. (Ärvd från Timeline) |
| From |
Hämtar eller anger animeringens startvärde. |
| HasAnimatedProperties |
Hämtar ett värde som anger om ett eller flera AnimationClock objekt är associerade med något av det här objektets beroendeegenskaper. (Ärvd från Animatable) |
| IsAdditive |
Hämtar eller anger ett värde som anger om målegenskapens aktuella värde ska läggas till i den här animeringens startvärde. |
| IsCumulative |
Hämtar eller anger ett värde som anger om animeringens värde ackumuleras när det upprepas. |
| IsDestinationDefault |
Hämtar ett värde som anger om den här animeringen använder parametern defaultDestinationValue för GetCurrentValue(Object, Object, AnimationClock) metoden som målvärde. (Ärvd från AnimationTimeline) |
| IsFrozen |
Hämtar ett värde som anger om objektet för närvarande kan ändras. (Ärvd från Freezable) |
| IsSealed |
Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad). (Ärvd från DependencyObject) |
| Name |
Hämtar eller anger namnet på den här Timeline. (Ärvd från Timeline) |
| RepeatBehavior |
Hämtar eller anger det upprepande beteendet för den här tidslinjen. (Ärvd från Timeline) |
| SpeedRatio |
Hämtar eller anger frekvensen, i förhållande till dess överordnade, vid vilken tidpunkt förlopp för detta Timeline. (Ärvd från Timeline) |
| TargetPropertyType |
Hämtar den typ av värde som animeringen genererar. (Ärvd från ColorAnimationBase) |
| To |
Hämtar eller anger animeringens slutvärde. |
Metoder
| Name | Description |
|---|---|
| AllocateClock() |
Skapar en Clock för detta AnimationTimeline. (Ärvd från AnimationTimeline) |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används den angivna HandoffBehavior . (Ärvd från Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace . (Ärvd från Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används den angivna HandoffBehavior egenskapen. (Ärvd från Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace . (Ärvd från Animatable) |
| CheckAccess() |
Avgör om den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| ClearValue(DependencyProperty) |
Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare. (Ärvd från DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey. (Ärvd från DependencyObject) |
| Clone() |
Skapar en modifierbar klon av detta ColorAnimationoch gör djupa kopior av objektets värden. När du kopierar beroendeegenskaper kopierar den här metoden resursreferenser och databindningar (men de kanske inte längre matchar) men inte animeringar eller deras aktuella värden. |
| CloneCore(Freezable) |
Gör instansen till en klon (djupkopia) av de angivna Freezable med hjälp av grundläggande (icke-animerade) egenskapsvärden. (Ärvd från Freezable) |
| CloneCurrentValue() |
Skapar en modifierbar klon av det här Timeline objektet, vilket gör djupa kopior av objektets aktuella värden. (Ärvd från Timeline) |
| CloneCurrentValueCore(Freezable) |
Gör instansen till en modifierbar klon (djupkopia) av den angivna Freezable med hjälp av aktuella egenskapsvärden. (Ärvd från Freezable) |
| CoerceValue(DependencyProperty) |
Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject. (Ärvd från DependencyObject) |
| CreateClock() |
Skapar en ny AnimationClock från den här AnimationTimeline. (Ärvd från AnimationTimeline) |
| CreateClock(Boolean) |
Skapar en ny Clock från detta Timeline och anger om den nya Clock är kontrollerbar. Om detta Timeline har underordnade, skapas ett träd med klockor med detta Timeline som rot. (Ärvd från Timeline) |
| CreateInstance() |
Initierar en ny instans av Freezable klassen. (Ärvd från Freezable) |
| CreateInstanceCore() |
Skapar en ny instans av ColorAnimation. |
| Equals(Object) |
Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject. (Ärvd från DependencyObject) |
| Freeze() |
Gör det aktuella objektet ommodifierbart och anger dess IsFrozen egenskap till |
| FreezeCore(Boolean) |
Gör detta Timeline ommodifierbart eller avgör om det kan göras ommodifierbart. (Ärvd från Timeline) |
| GetAnimationBaseValue(DependencyProperty) |
Returnerar det icke-animerade värdet för det angivna DependencyProperty. (Ärvd från Animatable) |
| GetAsFrozen() |
Skapar en frusen Freezablekopia av , med hjälp av grundläggande (icke-animerade) egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetAsFrozenCore(Freezable) |
Gör den här instansen till en klon av det angivna Timeline objektet. (Ärvd från Timeline) |
| GetCurrentValue(Color, Color, AnimationClock) |
Hämtar det aktuella värdet för animeringen. (Ärvd från ColorAnimationBase) |
| GetCurrentValue(Object, Object, AnimationClock) |
Hämtar det aktuella värdet för animeringen. (Ärvd från ColorAnimationBase) |
| GetCurrentValueAsFrozen() |
Skapar en frusen Freezable kopia av med aktuella egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Gör den här instansen till en frusen klon av angiven Timeline. Resursreferenser, databindningar och animeringar kopieras inte, men deras aktuella värden är det. (Ärvd från Timeline) |
| GetCurrentValueCore(Color, Color, AnimationClock) |
Beräknar ett värde som representerar det aktuella värdet för egenskapen som animerats, enligt .ColorAnimation |
| GetHashCode() |
Hämtar en hash-kod för den här DependencyObject. (Ärvd från DependencyObject) |
| GetLocalValueEnumerator() |
Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject. (Ärvd från DependencyObject) |
| GetNaturalDuration(Clock) |
Returnerar längden på en enskild iteration av den här Timeline. (Ärvd från Timeline) |
| GetNaturalDurationCore(Clock) |
Returnerar längden på en enskild iteration av den här AnimationTimeline. (Ärvd från AnimationTimeline) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetValue(DependencyProperty) |
Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject. (Ärvd från DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen. (Ärvd från DependencyObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnChanged() |
Anropas när det aktuella Freezable objektet ändras. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Den här medlemmen stöder infrastrukturen för Windows Presentation Foundation (WPF) och är inte avsedd att användas direkt från koden. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Ser till att lämpliga kontextpekare upprättas för en DependencyObjectType datamedlem som just har angetts. (Ärvd från Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Åsidosätter implementeringen DependencyObject av OnPropertyChanged(DependencyPropertyChangedEventArgs) för att även anropa alla Changed hanterare som svar på en ändrad beroendeegenskap av typen Freezable. (Ärvd från Freezable) |
| ReadLocalValue(DependencyProperty) |
Returnerar det lokala värdet för en beroendeegenskap, om den finns. (Ärvd från DependencyObject) |
| ReadPreamble() |
Säkerställer att åtkomsten Freezable görs från en giltig tråd. Arvtagare Freezable till måste anropa den här metoden i början av ett API som läser datamedlemmar som inte är beroendeegenskaper. (Ärvd från Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Anger värdet för en beroendeegenskap utan att ändra dess värdekälla. (Ärvd från DependencyObject) |
| SetValue(DependencyProperty, Object) |
Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare. (Ärvd från DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen. (Ärvd från DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen. (Ärvd från DependencyObject) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| VerifyAccess() |
Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| WritePostscript() |
Genererar Changed händelsen för Freezable och anropar dess OnChanged() metod. Klasser som härleds från Freezable bör anropa den här metoden i slutet av alla API:er som ändrar klassmedlemmar som inte lagras som beroendeegenskaper. (Ärvd från Freezable) |
| WritePreamble() |
Verifierar att Freezable inte är låst och att den nås från en giltig trådkontext. Freezable ärver bör anropa den här metoden i början av ett API som skriver till datamedlemmar som inte är beroendeegenskaper. (Ärvd från Freezable) |
Händelser
| Name | Description |
|---|---|
| Changed |
Inträffar när eller Freezable ett objekt som det innehåller ändras. (Ärvd från Freezable) |
| Completed |
Inträffar när tidslinjen har spelats upp helt: den kommer inte längre att gå in i den aktiva perioden. (Ärvd från Timeline) |
| CurrentGlobalSpeedInvalidated |
Inträffar när den hastighet med vilken tiden förlopp för tidslinjens klocka ändras. (Ärvd från Timeline) |
| CurrentStateInvalidated |
Inträffar när CurrentState egenskapen för tidslinjens Clock uppdateras. (Ärvd från Timeline) |
| CurrentTimeInvalidated |
Inträffar när CurrentTime egenskapen för tidslinjens Clock uppdateras. (Ärvd från Timeline) |
| RemoveRequested |
Inträffar när klockan som skapats för den här tidslinjen eller någon av dess överordnade tidslinjer tas bort. (Ärvd från Timeline) |