Compartilhar via


Método IUIAnimationTransitionLibrary::CreateAccelerateDecelerateTransition (uianimation.h)

Cria uma transição acelerada e desacelerada.

Sintaxe

HRESULT CreateAccelerateDecelerateTransition(
  [in]  UI_ANIMATION_SECONDS   duration,
  [in]  DOUBLE                 finalValue,
  [in]  DOUBLE                 accelerationRatio,
  [in]  DOUBLE                 decelerationRatio,
  [out] IUIAnimationTransition **transition
);

Parâmetros

[in] duration

A duração da transição.

[in] finalValue

O valor da variável de animação no final da transição.

[in] accelerationRatio

A proporção do tempo gasto acelerando até a duração.

[in] decelerationRatio

A proporção do tempo gasto desacelerando até a duração.

[out] transition

A nova transição acelerada e desacelerada.

Valor retornado

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

Durante uma transição entre aceleração e desaceleração, a variável de animação acelera e desacelera durante a transição, terminando em um valor especificado. Você pode controlar a rapidez com que a variável acelera e desacelera de forma independente ao especificar taxas de aceleração e desaceleração diferentes.

Quando a velocidade inicial é zero, a taxa de aceleração é a fração da duração que a variável gastará acelerando e o mesmo acontece na taxa de desaceleração. Se a velocidade inicial for diferente de zero, será a fração do tempo entre a velocidade atingindo zero e o fim da transição. A taxa de aceleração e a taxa de desaceleração devem somar um máximo de 1.0.

Os números abaixo mostram o efeito em variáveis de animação com diferentes velocidades iniciais durante transições de aceleração e desaceleração.

Diagrama mostrando transições aceleradas e desaceleradas
Observação d' na figura acima à direita mostra o tempo entre a velocidade atingindo zero e o final da transição.
 

Exemplos

Para obter um exemplo, consulte Criar um Storyboard e Adicionar Transições.

Requisitos

   
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

IUIAnimationTransition

IUIAnimationTransitionLibrary