IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged-Methode (uianimation.h)

Artikel
03/03/2024

Behandelt Ereignisse, die auftreten, wenn sich der Wert einer Animationsvariable ändert.

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

Syntax

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

Parameter

[in] storyboard

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

[in] variable

Die Animationsvariable, die aktualisiert wurde.

[in] newValue

Der neue Wert der Animationsvariable, gerundet gemäß dem Rundungsmodus der Variablen.

[in] previousValue

Der vorherige Wert der Animationsvariable, gerundet gemäß dem Rundungsmodus der Variablen.

Rückgabewert

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

Hinweise

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

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

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

Anforderungen

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