IUIAnimationTransitionLibrary2::CreateDiscreteTransition method (uianimation.h)

Creates a discrete scalar transition.

Syntax

HRESULT CreateDiscreteTransition(
  [in]  UI_ANIMATION_SECONDS    delay,
  [in]  DOUBLE                  finalValue,
  [in]  UI_ANIMATION_SECONDS    hold,
  [out] IUIAnimationTransition2 **transition
);

Parameters

[in] delay

The amount of time by which to delay the instantaneous switch to the final value.

[in] finalValue

The value of the animation variable at the end of the transition.

[in] hold

The amount of time by which to hold the variable at its final value.

[out] transition

The new discrete transition.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See Windows Animation Error Codes for a list of error codes.

Remarks

During a discrete transition, the animation variable remains at the initial value for a specified delay time, then switches instantaneously to a specified final value and remains at that value for a given hold time.

The following figure shows the change in value over time of an animation variable during a discrete transition.

Requirements

See also

IUIAnimationTransition2

IUIAnimationTransitionLibrary2