IUIAnimationVariableIntegerChangeHandler2：：OnIntegerValueChanged 方法 (uianimation.h)

处理当动画变量的整数值在指定维度中更改时发生的事件。

语法

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

参数

[in] storyboard

正在对变量参数指定的动画变量进行动画处理的 情节提要 。

[in] variable

已更新的动画变量。

[in] newValue

动画变量的新整数值。

注意 动画变量的舍入模式是使用 SetRoundingMode 方法指定的。

 

[in] previousValue

动画变量的上一个整数值。

注意 动画变量的舍入模式是使用 SetRoundingMode 方法指定的。

 

[in] cDimension

动画变量整数值更改的维度。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。 有关错误代码列表，请参阅 Windows 动画 错误代码。

注解

此方法以 INT32 值的形式接收更新。
若要以 DOUBLE 值的形式接收更新，请使用 OnValueChanged 方法。

OnIntegerValueChanged 事件的发生频率可能低于 OnValueChanged 事件，因为 2.2、2.3 和 2.4 等值将全部舍入为同一整数。

默认情况下，在回调方法中对任何其他动画方法的调用会导致调用失败并返回 UI_E_ILLEGAL_REENTRANCY。 但是，此默认值存在例外情况。 可以从 OnIntegerValueChanged 成功调用以下方法：

• GetValue
• GetFinalValue
• GetPreviousValue
• GetIntegerValue
• GetFinalIntegerValue
• GetPreviousIntegerValue
• GetCurrentStoryboard
• GetVariableFromTag
• GetStoryboardFromTag
• GetTag
• GetTag

要求

要求	值
最低受支持的客户端	Windows 8、Windows 7 和适用于 Windows 7 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	uianimation.h
DLL	UIAnimation.dll

另请参阅

IUIAnimationVariableChangeHandler2

IUIAnimationVariableIntegerChangeHandler2

OnValueChanged

SetVariableIntegerChangeHandler

UI_ANIMATION_ROUNDING_MODE