IUIAnimationVariableChangeHandler2::OnValueChanged method

Handles events that occur when the value of an animation variable changes in the specified dimension.

Syntax


HRESULT OnValueChanged(
  [in]  IUIAnimationStoryboard2 *storyboard,
  [in]  IUIAnimationVariable2 *variable,
  [in]  DOUBLE *newValue,
  [in]  DOUBLE *previousValue,
  [in]  UINT cDimension
);

Parameters

storyboard [in]

The storyboard that is animating the animation variable specified by the variable parameter.

variable [in]

The animation variable that has been updated.

newValue [in]

The new value of the animation variable.

previousValue [in]

The previous value of the animation variable.

cDimension [in]

The dimension in which the value of the animation variable changed.

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

This method receives updates as DOUBLE values. To receive updates as INT32 values, use the IUIAnimationVariableIntegerChangeHandler2::OnIntegerValueChanged method.

By default, a call made in a callback method to any other animation method results in the call failing and returning UI_E_ILLEGAL_REENTRANCY. However, there are exceptions to this default. The following methods can be successfully called from IUIAnimationVariableChangeHandler2::OnValueChanged:

Requirements

Minimum supported client

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

Minimum supported server

None supported [desktop apps | Windows Store apps]

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

IID

IID_IUIAnimationVariableChangeHandler2 is defined as 63ACC8D2-6EAE-4bb0-B879-586DD8CFBE42

See also

IUIAnimationVariableChangeHandler2
IUIAnimationVariable2::SetVariableChangeHandler
IUIAnimationVariableIntegerChangeHandler2
IUIAnimationVariableIntegerChangeHandler2::OnIntegerValueChanged

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.