IUIAnimationTransitionLibrary2::CreateDiscreteVectorTransition method

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

delay [in]

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

finalValue [in]

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

cDimension [in]

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

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