Compartilhar via


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

Para a dimensão fornecida, GetDependencies recupera os aspectos do interpolador que dependem do valor inicial ou da velocidade passada para o método IUIAnimationInterpolator2::SetInitialValueAndVelocity ou a duração passada para o método IUIAnimationInterpolator2::SetDuration .

Sintaxe

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

Parâmetros

[out] initialValueDependencies

Aspectos do interpolador que dependem do valor inicial passado para SetInitialValueAndVelocity.

[out] initialVelocityDependencies

Aspectos do interpolador que dependem da velocidade inicial passada para SetInitialValueAndVelocity.

[out] durationDependencies

Aspectos do interpolador que dependem da duração passada para SetDuration.

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

Esse método é chamado para identificar quais aspectos do interpolador personalizado são afetados por determinadas entradas: valor, velocidade e duração. Para cada uma dessas entradas, o interpolador retorna um dos seguintes:

  • O OR bit a bit de qualquer membro de UI_ANIMATION_DEPENDENCIES que se aplicam.
  • UI_ANIMATION_DEPENDENCY_NONE se nada depender da entrada.
Por exemplo, considere um interpolador que:
  • Aceita um valor final como um parâmetro.
  • Sempre chega a uma parada gradual nesse valor final.
  • Tem uma duração determinada pela diferença entre o valor final e o valor inicial.
Nesse caso, o interpolador deve retornar UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION para o parâmetro initialValueDependencies . Ele não deve retornar UI_ANIMATION_DEPENDENCY_FINAL_VALUE, pois esse valor é definido quando o interpolador é criado e não é afetado pelo valor inicial. Da mesma forma, o interpolador não deve retornar UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY, pois a inclinação da curva é definida como sempre zero quando atinge o valor final.

É importante que um interpolador retorne um conjunto correto de sinalizadores. Se um sinalizador não estiver presente para uma saída, a Animação do Windows pressupõe que o parâmetro correspondente não afete esse aspecto dos resultados do interpolador. Por exemplo, se o interpolador personalizado não incluir UI_ANIMATION_DEPENDENCY_FINAL_VALUE para initialVelocityDependencies, a Animação do Windows poderá chamar SetInitialValueAndVelocity com um parâmetro de velocidade arbitrária e chamar GetFinalValue para determinar o valor final. A implementação do interpolador de GetFinalValue deve retornar o mesmo resultado, independentemente de qual parâmetro de velocidade tenha sido passado para SetInitialValueAndVelocity, porque o interpolador alegou que o valor final da transição não depende da velocidade inicial.

Nota Se os sinalizadores retornados por durationDependencies não incluírem UI_ANIMATION_DEPENDENCY_DURATION, SetDuration nunca será chamado no interpolador.
 

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