Compartilhar via


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

Obtém os aspectos do interpolador que dependem do valor inicial ou da velocidade passada para SetInitialValueAndVelocity ou que dependem da duração passada para 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, 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 todos os membros de UI_ANIMATION_DEPENDENCIES que se aplicam.
  • UI_ANIMATION_DEPENDENCY_NONE se nada depender da entrada.
Por exemplo, considere um interpolador (1) que aceita um valor final como um parâmetro , (2) que sempre chega a uma parada gradual nesse valor final e (3) cuja duração é determinada pela diferença entre os valores finais e iniciais. O interpolador deve retornar UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION para initialValueDependencies. Ele não deve retornar UI_ANIMATION_DEPENDENCY_FINAL_VALUE porque isso é definido quando o interpolador é criado e não é afetado pelo valor inicial. Da mesma forma, ele não deve retornar UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY porque a inclinação da curva é definida como sempre zero quando atinge o valor final.

É importante que um interpolador retorne o 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 incluirem UI_ANIMATION_DEPENDENCY_DURATION, SetDuration nunca será chamado no interpolador.
 

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

Confira também

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES