Compartilhar via


Método IUIAnimationInterpolator2::InterpolateValue (uianimation.h)

Interpola o valor de uma variável de animação no deslocamento especificado e para a dimensão fornecida.

Sintaxe

HRESULT InterpolateValue(
  [in]  UI_ANIMATION_SECONDS offset,
  [out] DOUBLE               *value,
  [in]  UINT                 cDimension
);

Parâmetros

[in] offset

O deslocamento a partir do início da transição.

Esse parâmetro é sempre maior ou igual a zero e menor que a duração da transição. Esse método não será chamado se a duração da transição for zero.

[out] value

O valor interpolado.

[in] cDimension

A dimensão na qual interpolar o valor.

Retornar valor

Se o método for bem-sucedido, ele 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

A Animação do Windows sempre chama o método IUIAnimationInterpolator2::SetInitialValueAndVelocity para definir o valor inicial e a velocidade antes de chamar InterpolateValue, portanto, um interpolador personalizado não precisa marcar se o valor inicial e a velocidade foram definidos.

A Animação do Windows pode chamar SetInitialValueAndVelocity várias vezes com parâmetros diferentes. Os interpoladores podem armazenar em cache o estado interno para melhorar o desempenho, mas eles devem atualizar esse estado armazenado em cache sempre que SetInitialValueAndVelocity for chamado e garantir que os resultados das chamadas subsequentes para InterpolateValue reflitam o estado atualizado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8, Windows 7 e Platform Update para Windows 7 [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

Confira também

IUIAnimationInterpolator2

UI_ANIMATION_SECONDS