ColorAnimation Classe

Definizione

Spazio dei nomi:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Aggiunge un'animazione al valore di una proprietà Color tra due valori di destinazione usando l'interpolazione lineare per un oggetto Duration specificato.

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

Ereditarietà

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

ColorAnimationBase

ColorAnimation

Commenti

Un'animazione aggiorna il valore di una proprietà in un periodo di tempo. Un effetto di animazione può essere sottile, ad esempio lo spostamento di Shape alcuni pixel da sinistra e destra, o un effetto drammatico, ad esempio l'ingrandimento di un oggetto a 200 volte le dimensioni originali durante la rotazione e la modifica del colore. Per creare un'animazione in Windows Presentation Foundation (WPF), associare un'animazione al valore della proprietà di un oggetto.

Valori di destinazione

La ColorAnimation classe crea una transizione tra due valori di destinazione. Per impostare i valori di destinazione, usare le Fromrelative proprietà , Toe By . Nella tabella seguente viene riepilogato il modo in cui le Fromproprietà , Toe By possono essere usate insieme o separatamente per determinare i valori di destinazione di un'animazione.

Proprietà specificate	Comportamento risultante
From	L'animazione passa dal valore specificato dalla From proprietà al valore di base della proprietà animata o al valore di output di un'animazione precedente, a seconda della configurazione dell'animazione precedente.
From e To	L'animazione passa dal valore specificato dalla From proprietà al valore specificato dalla To proprietà .
From e By	L'animazione passa dal valore specificato dalla From proprietà al valore specificato dalla somma delle From proprietà e By .
To	L'animazione avanza dal valore di base della proprietà animata o dal valore di output di un'animazione precedente al valore specificato dalla To proprietà .
By	L'animazione passa dal valore di base della proprietà animata o dal valore di output di un'animazione precedente alla somma di tale valore e al valore specificato dalla By proprietà .

Nota

Se si impostano entrambe le To proprietà e By , la proprietà ha la To precedenza e la By proprietà viene ignorata.

Per usare altri metodi di interpolazione o animare tra più di due valori di destinazione, usare un ColorAnimationUsingKeyFrames oggetto .

Per informazioni sull'applicazione di più animazioni a una singola proprietà, vedere Cenni preliminari sulle animazioni con fotogrammi chiave.

Funzionalità di Freezable

Poiché la ColorAnimation classe eredita da Freezable, ColorAnimation gli oggetti ottengono diverse funzionalità speciali, tra cui le seguenti: possono essere dichiarate come risorse, condivise tra più oggetti, rese di sola lettura per migliorare le prestazioni, clonate e rese thread-safe. Per altre informazioni sulle diverse funzionalità fornite dagli Freezable oggetti, vedere Cenni preliminari sugli oggetti Freezable.

Costruttori

ColorAnimation()	Inizializza una nuova istanza della classe ColorAnimation.
ColorAnimation(Color, Color, Duration)	Inizializza una nuova istanza della classe ColorAnimation che aggiunge un'animazione dal valore iniziale al valore di destinazione specificati per la durata indicata.
ColorAnimation(Color, Color, Duration, FillBehavior)	Inizializza una nuova istanza della classe ColorAnimation che aggiunge un'animazione dal valore iniziale al valore di destinazione specificati per la durata indicata e con il comportamento di riempimento specificato.
ColorAnimation(Color, Duration)	Inizializza una nuova istanza della classe ColorAnimation che aggiunge un'animazione al valore specificato per la durata indicata. Il valore iniziale dell'animazione è il valore di base della proprietà a cui si sta aggiungendo un'animazione o l'output di un'altra animazione.
ColorAnimation(Color, Duration, FillBehavior)	Inizializza una nuova istanza della classe ColorAnimation che aggiunge un'animazione al valore specificato per la durata indicata e ha il comportamento di riempimento specificato. Il valore iniziale dell'animazione è il valore di base della proprietà a cui si sta aggiungendo un'animazione o l'output di un'altra animazione.

Campi

ByProperty	Identifica la proprietà di dipendenza By.
EasingFunctionProperty	Identifica la proprietà di dipendenza EasingFunction.
FromProperty	Identifica la proprietà di dipendenza From.
ToProperty	Identifica la proprietà di dipendenza To.

Proprietà

AccelerationRatio	Ottiene o imposta un valore che specifica la percentuale della Duration della sequenza temporale trascorsa accelerando il passaggio da zero alla frequenza massima. (Ereditato da Timeline)
AutoReverse	Ottiene o imposta un valore che indica se la sequenza temporale viene riprodotta in senso inverso dopo il completamento di un'iterazione in avanti. (Ereditato da Timeline)
BeginTime	Ottiene o imposta l'ora in cui deve iniziare questa Timeline. (Ereditato da Timeline)
By	Ottiene o imposta la quantità totale in base alla quale l'animazione modifica il valore iniziale.
CanFreeze	Ottiene un valore che indica se l'oggetto può essere impostato come non modificabile. (Ereditato da Freezable)
DecelerationRatio	Ottiene o imposta un valore che specifica la percentuale della Duration della sequenza temporale trascorsa decelerando il passaggio dalla frequenza massima a zero. (Ereditato da Timeline)
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
Duration	Ottiene o imposta la durata di riproduzione di questa sequenza temporale, senza contare le ripetizioni. (Ereditato da Timeline)
EasingFunction	Ottiene o imposta la funzione di interpolazione applicata all'animazione.
FillBehavior	Ottiene o imposta un valore che specifica come Timeline si comporti dopo avere raggiunto la fine del periodo attivo. (Ereditato da Timeline)
From	Ottiene o imposta il valore iniziale dell'animazione.
HasAnimatedProperties	Ottiene un valore che indica se uno o più oggetti AnimationClock sono associati a una qualsiasi delle proprietà di dipendenza di questo oggetto. (Ereditato da Animatable)
IsAdditive	Ottiene o imposta un valore che indica se il valore corrente della proprietà di destinazione deve essere aggiunto al valore iniziale dell'animazione.
IsCumulative	Ottiene o imposta un valore che specifica se il valore dell'animazione viene accumulato quando si ripete.
IsDestinationDefault	Ottiene un valore che indica se questa animazione usa il parametro defaultDestinationValue del metodo GetCurrentValue(Object, Object, AnimationClock) come valore di destinazione. (Ereditato da AnimationTimeline)
IsFrozen	Ottiene un valore che indica se l'oggetto è attualmente modificabile. (Ereditato da Freezable)
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Name	Ottiene o imposta il nome di Timeline. (Ereditato da Timeline)
RepeatBehavior	Ottiene o imposta il comportamento di ripetizione della sequenza temporale. (Ereditato da Timeline)
SpeedRatio	Ottiene o imposta la velocità, relativa al padre, di avanzamento del tempo per questa Timeline. (Ereditato da Timeline)
TargetPropertyType	Ottiene il tipo di valore generato da questa animazione. (Ereditato da ColorAnimationBase)
To	Ottiene o imposta il valore finale dell'animazione.

Metodi

AllocateClock()	Crea un oggetto Clock per questo oggetto AnimationTimeline. (Ereditato da AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se la proprietà è già animata, viene usato il comportamento di continuità di SnapshotAndReplace. (Ereditato da Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato. (Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se alla proprietà specificata è già applicata un'animazione, viene usato il comportamento di continuità di SnapshotAndReplace. (Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se alla proprietà specificata è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato. (Ereditato da Animatable)
CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
Clone()	Crea un clone modificabile di questo oggetto ColorAnimation, eseguendo copie complete dei valori dell'oggetto. Durante la copia delle proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (che potrebbero non essere più risolti), ma non le animazioni né i relativi valori correnti.
CloneCore(Freezable)	Rende l'istanza un clone (copia completa) dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati). (Ereditato da Freezable)
CloneCurrentValue()	Crea un clone modificabile dell'oggetto Timeline, eseguendo copie complete dei valori correnti di tale oggetto. (Ereditato da Timeline)
CloneCurrentValueCore(Freezable)	Rende l'istanza un clone (copia completa) modificabile dell'oggetto Freezable specificato usando i valori di proprietà correnti. (Ereditato da Freezable)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
CreateClock()	Crea un nuovo oggetto AnimationClock da questo oggetto AnimationTimeline. (Ereditato da AnimationTimeline)
CreateClock(Boolean)	Crea un nuovo Clock da questa Timeline e specifica se il nuovo Clock è controllabile. Se l'oggetto Timeline dispone di elementi figlio, viene creato un albero di orologi con Timeline come radice. (Ereditato da Timeline)
CreateInstance()	Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable)
CreateInstanceCore()	Crea una nuova istanza dell'oggetto ColorAnimation.
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
Freeze()	Rende non modificabile l'oggetto corrente e ne imposta la proprietà IsFrozen su true. (Ereditato da Freezable)
FreezeCore(Boolean)	Rende immodificabile questa Timeline o determina se può essere resa immodificabile. (Ereditato da Timeline)
GetAnimationBaseValue(DependencyProperty)	Restituisce il valore non animato dell'oggetto DependencyProperty specificato. (Ereditato da Animatable)
GetAsFrozen()	Crea una copia bloccata di Freezable, utilizzando valori delle proprietà di base (non-animati). Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable)
GetAsFrozenCore(Freezable)	Rende questa istanza un clone dell'oggetto Timeline specificato. (Ereditato da Timeline)
GetCurrentValue(Color, Color, AnimationClock)	Ottiene il valore corrente dell'animazione. (Ereditato da ColorAnimationBase)
GetCurrentValue(Object, Object, AnimationClock)	Ottiene il valore corrente dell'animazione. (Ereditato da ColorAnimationBase)
GetCurrentValueAsFrozen()	Crea una copia bloccata di Freezable utilizzando valori della proprietà correnti. Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rende questa istanza un clone bloccato dell'oggetto Timeline specificato. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma vengono copiati i relativi valori correnti. (Ereditato da Timeline)
GetCurrentValueCore(Color, Color, AnimationClock)	Calcola un valore che rappresenta il valore corrente della proprietà a cui viene aggiunta un'animazione, come determinato da ColorAnimation.
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetNaturalDuration(Clock)	Restituisce la lunghezza di una singola iterazione di questo oggetto Timeline. (Ereditato da Timeline)
GetNaturalDurationCore(Clock)	Restituisce la lunghezza di una singola iterazione di questo oggetto AnimationTimeline. (Ereditato da AnimationTimeline)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnChanged()	Chiamato quando viene modificato l'oggetto Freezable corrente. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Assicura che adatti puntatori del contesto siano stabiliti per un membro dati DependencyObjectType che è appena stato impostato. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Questo membro supporta l'infrastruttura Windows Presentation Foundation (WPF) e non deve essere usata direttamente dal codice. (Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza di tipo Freezable. (Ereditato da Freezable)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
ReadPreamble()	Assicura che l’accesso di Freezable sia stato eseguito da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)
WritePostscript()	Genera l'evento Changed per Freezable e richiama il metodo OnChanged(). Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri di classe che non sono archiviati come proprietà di dipendenza. (Ereditato da Freezable)
WritePreamble()	Verifica che l'oggetto Freezable non sia bloccato e che l'accesso sia eseguito da un contesto di threading valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che scrive sui membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable)

Eventi

Changed	Si verifica quando Freezable o un oggetto che contiene è modificato. (Ereditato da Freezable)
Completed	Si verifica quando questa sequenza temporale ha completamente terminato la riproduzione e non entrerà più nel periodo attivo. (Ereditato da Timeline)
CurrentGlobalSpeedInvalidated	Si verifica quando cambia la frequenza con cui avanza il tempo per il clock della sequenza temporale. (Ereditato da Timeline)
CurrentStateInvalidated	Si verifica quando viene aggiornata la proprietà CurrentState dell'oggetto Clock della sequenza temporale. (Ereditato da Timeline)
CurrentTimeInvalidated	Si verifica quando viene aggiornata la proprietà CurrentTime dell'oggetto Clock della sequenza temporale. (Ereditato da Timeline)
RemoveRequested	Si verifica quando il clock creato per questa sequenza temporale o una delle sequenze temporali padre viene rimosso. (Ereditato da Timeline)

Vedi anche

• ColorAnimationUsingKeyFrames
• Freezable