Método IUIAnimationStoryboard2::RepeatBetweenKeyframes (uianimation.h)
Crea un bucle entre dos fotogramas clave.
Sintaxis
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
Fotograma clave en el que se va a iniciar el bucle.
[in] endKeyframe
Fotograma clave en el que se va a finalizar el bucle. endKeyframe no debe producirse anteriormente en el guión gráfico que startKeyframe.
[in] cRepetition
Número de veces que se va a repetir el bucle; la última iteración de un bucle puede finalizar fraccionarse entre fotogramas clave. Un valor de cero indica que no se reproducirá la parte especificada de un guión gráfico. Un valor de UI_ANIMATION_REPEAT_INDEFINITELY (-1) indica que el bucle se repetirá indefinidamente hasta que se recorte o finalice el guión gráfico.
[in] repeatMode
Patrón para la iteración del bucle.
Un valor de UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) especifica que el inicio del bucle debe alternar entre fotogramas clave (k1-k2>, k2-k1>, k1-k2>, etc.).
Un valor de UI_ANIMATION_REPEAT_MODE_NORMAL (0) especifica que el inicio del bucle debe comenzar con el primer fotograma clave (k1-k2>, k1-k2>, k1-k2, k1-k2>, etc.).
[in] pIterationChangeHandler
Controlador para cada evento de iteración de bucle. El valor predeterminado es 0.
[in] id
Identificador de bucle que se va a pasar a pIterationChangeHandler. El valor predeterminado es 0.
[in] fRegisterForNextAnimationEvent
Si es true, especifica que pIterationChangeHandler se incorporará en la estimación del intervalo de tiempo hasta el siguiente evento de animación devuelto por el método IUIAnimationManager2::EstimateNextEventTime . El valor predeterminado es 0 o false.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.
Comentarios
Este método dirige un guión gráfico para reproducir el intervalo entre los fotogramas clave especificados repetidamente antes de reproducir el resto del guión gráfico. Si se especifica un recuento de repeticiones finito, el bucle siempre reproduce ese número de veces. Si se especifica UI_ANIMATION_REPEAT_INDEFINITELY (-1), el bucle se repite hasta que finalice el guión gráfico, en cuyo caso se completa la iteración actual del bucle y el resto del guión gráfico se reproduce. Un guión gráfico que se repite indefinidamente también finaliza si se trunca.
No se admiten bucles anidados y superpuestos.
Un fotograma clave representa un momento en el tiempo dentro de un guión gráfico y se puede usar para especificar las horas de inicio o finalización de las transiciones. Dado que los fotogramas clave se pueden agregar al final de las transiciones, es posible que no se conozcan sus desplazamientos desde el principio del guión gráfico hasta que se esté reproduciendo el guión gráfico.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8, Windows 7 y Actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | uianimation.h |
| Archivo DLL | UIAnimation.dll |