IUIAnimationManager2::CreateAnimationVectorVariable method (uianimation.h)

Creates a new animation variable for each specified dimension.

Syntax

HRESULT CreateAnimationVectorVariable(
  [in]          const DOUBLE          *initialValue,
  [in]          UINT                  cDimension,
  [out, retval] IUIAnimationVariable2 **variable
);

Parameters

[in] initialValue

A vector (of size cDimension) of initial values for the animation variable.

[in] cDimension

The number of dimensions that require animated values. This parameter specifies the number of values listed in initialValue.

[out, retval] variable

The new animation variable.

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

The initial value of an animation variable is specified when the variable is created. After an animation variable is created, its value cannot be changed directly; it must be updated through the animation manager.

An animation variable is typically created to represent each visual characteristic that is to be animated. For example, an application might create three animation variables for the X, Y, and Z coordinates of an object that can move freely within a three-dimensional space.

Requirements

See also

IUIAnimationManager2