DiscreteObjectKeyFrame DiscreteObjectKeyFrame DiscreteObjectKeyFrame DiscreteObjectKeyFrame Class


Animates from the Object value of the previous key frame to its own Value using discrete values.

public : sealed class DiscreteObjectKeyFrame : ObjectKeyFrame
struct winrt::Windows::UI::Xaml::Media::Animation::DiscreteObjectKeyFrame : ObjectKeyFrame
public sealed class DiscreteObjectKeyFrame : ObjectKeyFrame
Public NotInheritable Class DiscreteObjectKeyFrame Inherits ObjectKeyFrame
<DiscreteObjectKeyFrame ...>
</DiscreteObjectKeyFrame ...>
</DiscreteObjectKeyFrame Value="objectAsAttribute"...>

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


Key-frame animations permit more than one target value that is reached at a point along the animation timeline. In other words each key frame can specify a different intermediate value, and the last key frame reached is the final animation value. By specifying multiple values to animate, you can make more complex animations.

DiscreteObjectKeyFrame is the only keyframe type permitted in an ObjectAnimationUsingKeyFrames. There are no linear interpolations or other interpolation logic that's possible for changing object values as the animation runs. The old object is removed at the KeyTime and the new object that is the value of the keyframe with that KeyTime replaces it.

There are several scenarios where using ObjectAnimationUsingKeyFrames rather than a typed animation is useful. Some of them are:

  • Creating the Storyboard for a visual state and using a value that is a {StaticResource} markup extension reference, rather than one of the typed values. This gives you the ability to reference system theme resources from a visual state. For more info see Storyboarded animations for visual states.
  • Animating int or byte values.
  • Animating structures used in UI definitions and visual states, such as GridLength. You can't animate the properties of the structure but you can swap the entire structure value with a DiscreteObjectKeyFrame and a new GridLength.

For more info on how to use key-frame animations, see Key-frame animations and easing function animations.


DiscreteObjectKeyFrame() DiscreteObjectKeyFrame() DiscreteObjectKeyFrame() DiscreteObjectKeyFrame()

Initializes a new instance of the DiscreteObjectKeyFrame class.


ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Clears the local value of a dependency property.

(Inherited from DependencyObject)
GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Returns any base value established for a dependency property, which would apply in cases where an animation is not active.

(Inherited from DependencyObject)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Returns the current effective value of a dependency property from a DependencyObject.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Returns the local value of a dependency property, if a local value is set.

(Inherited from DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance.

(Inherited from DependencyObject)
SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Sets the local value of a dependency property on a DependencyObject.

(Inherited from DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback.

(Inherited from DependencyObject)


Dispatcher Dispatcher Dispatcher Dispatcher

Gets the CoreDispatcher that this object is associated with. The CoreDispatcher represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread.

(Inherited from DependencyObject)
KeyTime KeyTime KeyTime KeyTime

Gets or sets the time at which the key frame's target Value should be reached.

(Inherited from ObjectKeyFrame)
KeyTimeProperty KeyTimeProperty KeyTimeProperty KeyTimeProperty

Identifies the KeyTime dependency property.

(Inherited from ObjectKeyFrame)
Value Value Value Value

Gets or sets the key frame's target value.

(Inherited from ObjectKeyFrame)
ValueProperty ValueProperty ValueProperty ValueProperty

Identifies the Value dependency property.

(Inherited from ObjectKeyFrame)

See also