Método IUIAnimationStoryboard::AddTransitionBetweenKeyframes (uianimation.h)

Artigo
08/26/2023

Adiciona uma transição entre dois quadros-chave.

Sintaxe

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

Parâmetros

[in] variable

A variável de animação para a qual a transição deve ser adicionada.

[in] transition

A transição a ser adicionada.

[in] startKeyframe

Um quadro-chave que especifica o início da nova transição.

[in] endKeyframe

Um quadro-chave que especifica o final da nova transição. Não é possível que endKeyframe apareça anteriormente no storyboard do que startKeyframe.

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.

Código de retorno	Descrição
UI_E_TRANSITION_ALREADY_USED	Essa transição já foi adicionada a um storyboard ou foi adicionada a um storyboard que terminou de ser reproduzido e lançado.
UI_E_TRANSITION_ECLIPSED	A transição pode eclipsar o início de outra transição no storyboard.
UI_E_START_KEYFRAME_AFTER_END	O quadro-chave inicial pode ocorrer após o quadro-chave final.

Comentários

Esse método aplica a transição especificada à variável especificada no storyboard, com a transição iniciando e terminando nos quadros-chave especificados. Se a transição tiver sido criada com um parâmetro de duração especificado, essa duração será substituída pela duração do período entre os quadros-chave inicial e final. Caso contrário, a Animação do Windows acelerará ou diminuirá a transição conforme necessário.

Um quadro-chave representa um momento em um storyboard e pode ser usado para especificar os horários de início e término das transições. Como os quadros-chave podem ser adicionados ao final das transições, seus deslocamentos desde o início do storyboard podem não ser conhecidos até que o storyboard esteja sendo reproduzido.

As transições devem ser adicionadas na ordem em que serão reproduzidas. Uma transição pode começar a ser reproduzida antes que a transição anterior no storyboard seja concluída. Nesse caso, o valor inicial e a velocidade vistos pela nova transição serão determinados pelo estado do anterior. Não é possível que uma transição comece antes do início da transição anterior.

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