IUIAnimationTransitionLibrary::CreateDiscreteTransition method (uianimation.h)

Creates a discrete transition.

Syntax

HRESULT CreateDiscreteTransition(
  [in]  UI_ANIMATION_SECONDS   delay,
  [in]  DOUBLE                 finalValue,
  [in]  UI_ANIMATION_SECONDS   hold,
  [out] IUIAnimationTransition **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 the 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 figure below shows the effect on an animation variable over time during a discrete transition.

Diagram showing a discrete transition

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server None supported
Target Platform Windows
Header uianimation.h
DLL UIAnimation.dll

See also

IUIAnimationTransition

IUIAnimationTransitionLibrary