Skip to main content

Windows Dev Center

IUIAnimationTransitionLibrary2::CreateSmoothStopTransition method

Creates a smooth-stop scalar transition.

Syntax


HRESULT CreateSmoothStopTransition(
  [in]  UI_ANIMATION_SECONDS   maximumDuration,
  [in]  DOUBLE                 finalValue,
  [out] IUIAnimationTransition **transition
);

Parameters

maximumDuration [in]

The maximum duration of the transition.

finalValue [in]

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

transition [out]

The new smooth-stop 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

A smooth-stop transition slows down as it approaches the specified final value, and reaches the final value with a velocity of zero. The duration of the transition is determined by the initial velocity, the difference between the initial and final values, and the specified maximum duration. If there is no solution consisting of a single parabolic arc, this method creates a cubic transition.

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

Diagram showing a smoth stop transition

Requirements

Minimum supported client

Windows 8, Windows 7 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

None supported

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

IID

IID_IUIAnimationTransitionLibrary2 is defined as 03CFAE53-9580-4ee3-B363-2ECE51B4AF6A

See also

IUIAnimationTransitionLibrary2
IUIAnimationTransition2