Método IUIAnimationStoryboard::RepeatBetweenKeyframes (uianimation.h)
Cria um loop entre dois quadros-chave especificados.
Sintaxe
HRESULT RepeatBetweenKeyframes(
[in] UI_ANIMATION_KEYFRAME startKeyframe,
[in] UI_ANIMATION_KEYFRAME endKeyframe,
[in] INT32 repetitionCount
);
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. Não é possível que endKeyframe ocorra anteriormente no storyboard do que startKeyframe.
[in] repetitionCount
O número de vezes que o loop deve ser repetido; esse parâmetro deve ser 0 ou um número positivo. Use UI_ANIMATION_REPEAT_INDEFINITELY (-1) para repetir o loop indefinidamente até que o storyboard seja cortado ou concluído.
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.
| Código de retorno | Descrição |
|---|---|
|
O quadro-chave inicial pode ocorrer após o quadro-chave final. |
|
Talvez não seja possível determinar o tempo de quadro-chave final quando o quadro-chave inicial for atingido. |
|
Duas partes repetidas de um storyboard podem se sobrepor. |
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 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 |