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