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

Artículo
08/26/2023

Agrega una transición entre dos fotogramas clave.

Sintaxis

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

Parámetros

[in] variable

Variable de animación para la que se va a agregar la transición.

[in] transition

Transición que se va a agregar.

[in] startKeyframe

Fotograma clave que especifica el principio de la nueva transición.

[in] endKeyframe

Fotograma clave que especifica el final de la nueva transición. No es posible que endKeyframe aparezca anteriormente en el guión gráfico que startKeyframe.

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_TRANSITION_ALREADY_USED	Esta transición ya se ha agregado a un guión gráfico o se ha agregado a un guión gráfico que ha terminado de reproducirse y se ha liberado.
UI_E_TRANSITION_ECLIPSED	La transición podría eclipsar el principio de otra transición en el guión gráfico.
UI_E_START_KEYFRAME_AFTER_END	El fotograma clave inicial puede producirse después del fotograma clave final.

Comentarios

Este método aplica la transición especificada a la variable especificada en el guión gráfico, con la transición que comienza y termina en los fotogramas clave especificados. Si la transición se creó con un parámetro de duración especificado, esa duración se sobrescribe con la duración del tiempo entre los fotogramas clave inicial y final. De lo contrario, la animación de Windows acelera o ralentiza la transición según sea necesario.

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 y 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.

Las transiciones se deben agregar en el orden en que se reproducirán. Una transición puede comenzar a reproducirse antes de que finalice la transición anterior en el guión gráfico, en cuyo caso el valor inicial y la velocidad vistos por la nueva transición se determinarán por el estado del anterior. No es posible que una transición comience antes del inicio de la transición anterior.

Requisitos


Cliente mínimo compatible	Windows 7, Windows Vista y Actualización de plataforma 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