Compartir a través de


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

Crea un bucle entre dos fotogramas clave especificados.

Sintaxis

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME startKeyframe,
  [in] UI_ANIMATION_KEYFRAME endKeyframe,
  [in] INT32                 repetitionCount
);

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. No es posible que endKeyframe se produzca anteriormente en el guión gráfico que startKeyframe.

[in] repetitionCount

Número de veces que se va a repetir el bucle; este parámetro debe ser 0 o un número positivo. Use UI_ANIMATION_REPEAT_INDEFINITELY (-1) para repetir el bucle indefinidamente hasta que se recorte o finalice el guión gráfico.

Valor devuelto

Si el 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.

Código devuelto Descripción
UI_E_START_KEYFRAME_AFTER_END
El fotograma clave inicial puede producirse después del fotograma clave final.
UI_E_END_KEYFRAME_NOT_DETERMINED
Es posible que no sea posible determinar la hora del fotograma clave final cuando se alcanza el fotograma clave inicial.
UI_E_LOOPS_OVERLAP
Dos partes repetidas de un guión gráfico pueden superponerse.

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 se concluye el guión gráfico, en cuyo caso la iteración actual del bucle se completa 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 sus desplazamientos desde el principio del guión gráfico no se conozcan hasta que se esté reproduciendo el guión gráfico.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista y Platform Update para Windows Vista [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

Consulte también

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset