Método IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged (uianimation.h)

Artículo
03/03/2024

Controla los eventos que se producen cuando cambia el valor de una variable de animación.

Este método recibe actualizaciones como valores INT32 . Para recibir actualizaciones como valores DOUBLE , use el método IUIAnimationVariableChangeHandler::OnValueChanged .

Sintaxis

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

Parámetros

[in] storyboard

Guión gráfico que anima la variable de animación especificada por el parámetro variable .

[in] variable

Variable de animación que se ha actualizado.

[in] newValue

Nuevo valor de la variable de animación, redondeado según el modo de redondeo de la variable.

[in] previousValue

Valor anterior de la variable de animación, redondeado según el modo de redondeo de la variable.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.

Comentarios

El modo de redondeo de una variable de animación se especifica mediante el método IUIAnimationVariable::SetRoundingMode .

Los eventos OnIntegerValueChanged pueden producirse con menos frecuencia que los eventos OnValueChanged porque los valores como 2.2, 2.3, 2.4 se redondean al mismo entero.

De forma predeterminada, una llamada realizada en un método de devolución de llamada a cualquier otro método de animación produce un error en la llamada y devuelve UI_E_ILLEGAL_REENTRANCY. Sin embargo, hay excepciones a este valor predeterminado. Se puede llamar correctamente a los métodos siguientes desde OnIntegerValueChanged:

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	uianimation.h
Archivo DLL	UIAnimation.dll