IUIAnimationVariableIntegerChangeHandler2::OnIntegerValueChanged-Methode (uianimation.h)

Artikel
03/06/2024

Behandelt Ereignisse, die auftreten, wenn sich der ganzzahlige Wert einer Animationsvariablen in der angegebenen Dimension ändert.

Syntax

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

Parameter

[in] storyboard

Das Storyboard, das die durch den Variablenparameter angegebene Animationsvariable animiert.

[in] variable

Die Animationsvariable, die aktualisiert wurde.

[in] newValue

Der neue ganzzahlige Wert der Animationsvariablen.

Hinweis Der Rundungsmodus für eine Animationsvariable wird mithilfe der SetRoundingMode-Methode angegeben.

[in] previousValue

Der vorherige ganzzahlige Wert der Animationsvariable.

Hinweis Der Rundungsmodus für eine Animationsvariable wird mithilfe der SetRoundingMode-Methode angegeben.

[in] cDimension

Die Dimension, in der sich der ganzzahlige Wert der Animationsvariablen geändert hat.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Fehlercodes für die Windows-Animation .

Hinweise

Diese Methode empfängt Updates als INT32-Werte .
Um Updates als DOUBLE-Werte zu erhalten, verwenden Sie die OnValueChanged-Methode .

OnIntegerValueChanged-Ereignisse treten möglicherweise weniger häufig auf als OnValueChanged-Ereignisse , da Werte wie 2.2, 2.3 und 2.4 alle auf dieselbe ganze Zahl gerundet würden.

Standardmäßig führt ein Aufruf, der in einer Rückrufmethode für eine andere Animationsmethode ausgeführt wird, dazu, dass der Aufruf fehlschlägt und UI_E_ILLEGAL_REENTRANCY zurückgibt. Es gibt jedoch Ausnahmen für diesen Standardwert. Die folgenden Methoden können erfolgreich von OnIntegerValueChanged aufgerufen werden:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8, Windows 7 und Platform Update für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	uianimation.h
DLL	UIAnimation.dll

Weitere Informationen

IUIAnimationVariableChangeHandler2

IUIAnimationVariableIntegerChangeHandler2

Onvaluechanged

SetVariableIntegerChangeHandler

UI_ANIMATION_ROUNDING_MODE

Freigeben über