IUIAnimationVariableIntegerChangeHandler：：OnIntegerValueChanged 方法 (uianimation.h)

發行項
03/13/2024

處理動畫變數的值變更時所發生的事件。

這個方法會以 INT32 值的形式接收更新。若要以 DOUBLE 值接收更新，請使用 IUIAnimationVariableChangeHandler：：OnValueChanged 方法。

語法

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

參數

[in] storyboard

以動畫顯示變數參數所指定動畫變數的分鏡腳本。

[in] variable

已更新的動畫變數。

[in] newValue

動畫變數的新值，會根據變數的捨入模式四捨五入。

[in] previousValue

動畫變數的先前值，會根據變數的捨入模式四捨五入。

傳回值

如果方法成功，它會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼的清單，請參閱 Windows 動畫錯誤碼。

備註

動畫變數的捨入模式是使用 IUIAnimationVariable：：SetRoundingMode 方法來指定。

OnIntegerValueChanged 事件的頻率可能會比 OnValueChanged 事件少，因為 2.2、2.3、2.4 等值全都會四捨五入為相同的整數。

根據預設，回呼方法對任何其他動畫方法進行的呼叫會導致呼叫失敗並傳回 UI_E_ILLEGAL_REENTRANCY。不過，此預設值有例外狀況。您可以從 OnIntegerValueChanged 成功呼叫下列方法：

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	uianimation.h
Dll	UIAnimation.dll