IUIAnimationTransitionLibrary2::CreateLinearVectorTransition method (uianimation.h)

Creates a linear vector transition in the specified dimension.

Syntax

HRESULT CreateLinearVectorTransition(
  [in]  UI_ANIMATION_SECONDS    duration,
  [in]  const DOUBLE            *finalValue,
  [in]  UINT                    cDimension,
  [out] IUIAnimationTransition2 **transition
);

Parameters

[in] duration

The duration of the transition.

[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.

[out] transition

The new linear 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 linear transition, the value of the animation variable transitions linearly from its initial value to a specified final value.

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

Diagram showing a linear transition

Requirements

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

See also

IUIAnimationTransition2

IUIAnimationTransitionLibrary2