Método IUIAnimationStoryboard2::RepeatBetweenKeyframes (uianimation.h)
Cria um loop entre dois quadros-chave.
Sintaxe
HRESULT RepeatBetweenKeyframes(
[in] UI_ANIMATION_KEYFRAME startKeyframe,
[in] UI_ANIMATION_KEYFRAME endKeyframe,
[in] DOUBLE cRepetition,
[in] UI_ANIMATION_REPEAT_MODE repeatMode,
[in] IUIAnimationLoopIterationChangeHandler2 *pIterationChangeHandler,
[in] UINT_PTR id,
[in] BOOL fRegisterForNextAnimationEvent
);
Parâmetros
[in] startKeyframe
O quadro-chave no qual o loop deve começar.
[in] endKeyframe
O quadro-chave no qual o loop deve terminar. endKeyframe não deve ocorrer anteriormente no storyboard do que startKeyframe.
[in] cRepetition
O número de vezes que o loop deve ser repetido; a última iteração de um loop pode terminar fracionáriamente entre keyframes. Um valor zero indica que a parte especificada de um storyboard não será reproduzida. Um valor de UI_ANIMATION_REPEAT_INDEFINITELY (-1) indica que o loop será repetido indefinidamente até que o storyboard seja cortado ou concluído.
[in] repeatMode
O padrão para a iteração de loop.
Um valor de UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) especifica que o início do loop deve alternar entre keyframes (k1-k2>, k2-k1>, k1-k2> e assim por diante).
Um valor de UI_ANIMATION_REPEAT_MODE_NORMAL (0) especifica que o início do loop deve começar com o primeiro quadro-chave (k1-k2>, k1-k2>, k1-k2> e assim por diante).
[in] pIterationChangeHandler
O manipulador para cada evento de iteração de loop. O valor padrão é 0.
[in] id
A ID do loop a ser passada para pIterationChangeHandler. O valor padrão é 0.
[in] fRegisterForNextAnimationEvent
Se true, especifica que pIterationChangeHandler será incorporado à estimativa do intervalo de tempo até o próximo evento de animação retornado pelo método IUIAnimationManager2::EstimateNextEventTime . O valor padrão é 0 ou false.
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 direciona um storyboard para reproduzir o intervalo entre os quadros-chave especificados repetidamente antes de reproduzir o restante do storyboard. Se uma contagem de repetição finita for especificada, o loop sempre reproduzirá esse número de vezes. Se UI_ANIMATION_REPEAT_INDEFINITELY (-1) for especificado, o loop se repetirá até que o storyboard seja concluído, nesse caso, a iteração atual do loop será concluída e o restante do storyboard será reproduzido. Um storyboard que faz loop indefinidamente também termina se ele estiver truncado.
Não há suporte para loops aninhados e sobrepostos.
Um quadro-chave representa um momento no tempo dentro de um storyboard e pode ser usado para especificar os horários de início ou 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.
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 |