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

Artigo
03/03/2024

Manipula eventos que ocorrem quando o valor de uma variável de animação é alterado.

Esse método recebe atualizações como valores INT32 . Para receber atualizações como valores DOUBLE , use o método IUIAnimationVariableChangeHandler::OnValueChanged .

Sintaxe

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

Parâmetros

[in] storyboard

O storyboard que está animando a variável de animação especificada pelo parâmetro de variável .

[in] variable

A variável de animação que foi atualizada.

[in] newValue

O novo valor da variável de animação, arredondado de acordo com o modo de arredondamento da variável.

[in] previousValue

O valor anterior da variável de animação, arredondado de acordo com o modo de arredondamento da variável.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

Comentários

O modo de arredondamento para uma variável de animação é especificado usando o método IUIAnimationVariable::SetRoundingMode .

Os eventos OnIntegerValueChanged podem ocorrer com menos frequência do que os eventos OnValueChanged porque valores como 2.2, 2.3, 2.4 seriam arredondados para o mesmo inteiro.

Por padrão, uma chamada feita em um método de retorno de chamada para qualquer outro método de animação resulta na falha da chamada e no retorno de UI_E_ILLEGAL_REENTRANCY. No entanto, há exceções a esse padrão. Os métodos a seguir podem ser chamados com êxito de OnIntegerValueChanged:

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	uianimation.h
DLL	UIAnimation.dll