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

Artigo
08/26/2023

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

Sintaxe

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *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.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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.

Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

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, o Windows Animation acelerará ou reduzirá 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 do 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 da transição anterior no storyboard terminar, 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

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