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

Artículo
08/26/2023

Agrega un fotograma clave en el desplazamiento especificado desde un fotograma clave existente.

Sintaxis

HRESULT AddKeyframeAtOffset(
  [in]  UI_ANIMATION_KEYFRAME existingKeyframe,
  [in]  UI_ANIMATION_SECONDS  offset,
  [out] UI_ANIMATION_KEYFRAME *keyframe
);

Parámetros

[in] existingKeyframe

Fotograma clave existente. Para agregar un fotograma clave en un desplazamiento desde el principio del guión gráfico, use el UI_ANIMATION_KEYFRAME_STORYBOARD_START de fotograma clave especial.

[in] offset

Desplazamiento del fotograma clave existente en el que se va a agregar un nuevo fotograma clave.

[out] keyframe

Fotograma clave que se va a agregar.

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.

Comentarios

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.

Ejemplos

El código siguiente agrega un fotograma clave en un desplazamiento fijo de 0,3 segundos desde el fotograma clave al principio del guión gráfico.

const UI_ANIMATION_SECONDS offset = 0.3;

UI_ANIMATION_KEYFRAME keyframe1;
hr = pStoryboard->AddKeyframeAtOffset(
       UI_ANIMATION_KEYFRAME_STORYBOARD_START,
       offset,
       &keyframe1
);

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