IUIAnimationTransitionLibrary2::CreateDiscreteTransition method

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

delay [in]

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

finalValue [in]

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

hold [in]

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

transition [out]

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

IUIAnimationTransitionLibrary2

IUIAnimationTransition2