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

Artigo
08/26/2023

Adiciona um quadro-chave no deslocamento especificado de um quadro-chave existente.

Sintaxe

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

Parâmetros

[in] existingKeyframe

O quadro-chave existente. Para adicionar um quadro-chave em um deslocamento desde o início do storyboard, use o quadro-chave especial UI_ANIMATION_KEYFRAME_STORYBOARD_START.

[in] offset

O deslocamento do quadro-chave existente no qual um novo quadro-chave deve ser adicionado.

[out] keyframe

O quadro-chave a ser adicionado.

Valor retornado

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.

Comentários

Um quadro-chave representa um momento em um storyboard e pode ser usado para especificar os horários de início e 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.

Exemplos

O código a seguir adiciona um quadro-chave a um deslocamento fixo de 0,3 segundos do quadro-chave no início do storyboard.

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