MatrixAnimationBase.GetCurrentValueCore Method

Definition

Namespace:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

When implemented in a derived class, calculates the current value of the animation.

protected:
 abstract System::Windows::Media::Matrix GetCurrentValueCore(System::Windows::Media::Matrix defaultOriginValue, System::Windows::Media::Matrix defaultDestinationValue, System::Windows::Media::Animation::AnimationClock ^ animationClock);

protected abstract System.Windows.Media.Matrix GetCurrentValueCore (System.Windows.Media.Matrix defaultOriginValue, System.Windows.Media.Matrix defaultDestinationValue, System.Windows.Media.Animation.AnimationClock animationClock);

abstract member GetCurrentValueCore : System.Windows.Media.Matrix * System.Windows.Media.Matrix * System.Windows.Media.Animation.AnimationClock -> System.Windows.Media.Matrix

Protected MustOverride Function GetCurrentValueCore (defaultOriginValue As Matrix, defaultDestinationValue As Matrix, animationClock As AnimationClock) As Matrix

Parameters

defaultOriginValue

Matrix

The suggested origin value, used if the animation does not have its own explicitly set start value.

defaultDestinationValue

Matrix

The suggested destination value, used if the animation does not have its own explicitly set end value.

animationClock

AnimationClock

An AnimationClock that generates the CurrentTime or CurrentProgress used by the host animation.

Returns

Matrix

The value this animation believes should be the current value for the property.

Remarks

The value of the defaultOriginValue parameter depends on the animation's position in the composition chain:

• If the animation is in the first position in a composition chain and it replaces another animation, defaultOriginValue is the output of that animation at the time it was replaced.

• If the animation is in the first position in a composition chain and no animation exists to replace, defaultOriginValue is the base value of the animated property.

• If this animation is not in the first position of a composition chain, then defaultOriginValue is the value that is returned by the previous animation in the composition chain that has an AnimationClock that is not Stopped.

The value of the defaultDestinationValue parameter depends on whether there is a previous property Trigger composition layer.

• If there is a previous property Trigger composition layer, defaultDestinationValue is the output from that layer.

• If there is no previous composition layer, defaultDestinationValue is the base value of the property that you are animating.

For more information about animation composition, see the Animation and Timing System Overview. For more information about creating custom animation types, see the Custom Animations Overview.