Metodo IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged (uianimation.h)

Articolo
03/13/2024

Gestisce gli eventi che si verificano quando il valore di una variabile di animazione cambia.

Questo metodo riceve gli aggiornamenti come valori INT32 . Per ricevere gli aggiornamenti come valori DOUBLE , usare il metodo IUIAnimationVariableChangeHandler::OnValueChanged .

Sintassi

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

Parametri

[in] storyboard

Storyboard che anima la variabile di animazione specificata dal parametro variabile .

[in] variable

Variabile di animazione aggiornata.

[in] newValue

Nuovo valore della variabile di animazione, arrotondato in base alla modalità di arrotondamento della variabile.

[in] previousValue

Il valore precedente della variabile di animazione, arrotondato in base alla modalità di arrotondamento della variabile.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore dell'animazione di Windows .

Commenti

La modalità di arrotondamento per una variabile di animazione viene specificata usando il metodo IUIAnimationVariable::SetRoundingMode .

Gli eventi OnIntegerValueChanged potrebbero verificarsi meno frequentemente degli eventi OnValueChanged perché i valori come 2.2, 2.3, 2.4 verranno arrotondati allo stesso intero.

Per impostazione predefinita, una chiamata effettuata in un metodo di callback a qualsiasi altro metodo di animazione comporta l'esito negativo della chiamata e la restituzione di UI_E_ILLEGAL_REENTRANCY. Tuttavia, esistono eccezioni a questo valore predefinito. I metodi seguenti possono essere chiamati correttamente da OnIntegerValueChanged:

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	uianimation.h
DLL	UIAnimation.dll