Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged method

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

This method receives updates as INT32 values. To receive updates as DOUBLE values, use the IUIAnimationVariableChangeHandler::OnValueChanged method.

Syntax


HRESULT OnIntegerValueChanged(
  [in]  IUIAnimationStoryboard *storyboard,
  [in]  IUIAnimationVariable *variable,
  [in]  INT32 newValue,
  [in]  INT32 previousValue
);

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, rounded according to the variable's rounding mode.

previousValue [in]

The previous value of the animation variable, rounded according to the variable's rounding mode.

Return value

If the 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 rounding mode for an animation variable is specified using the IUIAnimationVariable::SetRoundingMode method.

OnIntegerValueChanged events might occur less frequently than OnValueChanged events because values such as 2.2, 2.3, 2.4 would all be rounded to the same integer.

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 OnIntegerValueChanged:

Requirements

Minimum supported client

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

Minimum supported server

None supported [desktop apps | Windows Store apps]

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

See also

IUIAnimationVariableIntegerChangeHandler
IUIAnimationVariable::GetIntegerValue
IUIAnimationVariable::GetPreviousIntegerValue
IUIAnimationVariable::SetRoundingMode
IUIAnimationVariable::SetVariableIntegerChangeHandler
IUIAnimationVariableChangeHandler::OnValueChanged
UI_ANIMATION_ROUNDING_MODE

 

 

Community Additions

Show:
© 2014 Microsoft