IUIAnimationTransitionLibrary2::CreateDiscreteVectorTransition method (uianimation.h)

Creates a discrete vector transition for each specified dimension.

Syntax

HRESULT CreateDiscreteVectorTransition(
  [in]  UI_ANIMATION_SECONDS    delay,
  [in]  const DOUBLE            *finalValue,
  [in]  UINT                    cDimension,
  [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

A vector (of size cDimension) that contains the final values of the animation variable at the end of the transition.

[in] cDimension

The number of dimensions to apply the transition. This parameter specifies the number of values listed in finalValue.

[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