Метод IUIAnimationStoryboard::AddKeyframeAtOffset (uianimation.h)

Статья
08/26/2023

Добавляет ключевой кадр с указанным смещением из существующего ключевого кадра.

Синтаксис

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

Параметры

[in] existingKeyframe

Существующий ключевой кадр. Чтобы добавить ключевой кадр со смещением от начала раскадровки, используйте специальный UI_ANIMATION_KEYFRAME_STORYBOARD_START ключевого кадра.

[in] offset

Смещение от существующего ключевого кадра, в который необходимо добавить новый ключевой кадр.

[out] keyframe

Добавляемый ключевой кадр.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок анимации Windows .

Ключевой кадр представляет момент времени в раскадровки и может использоваться для указания времени начала и окончания переходов. Так как ключевые кадры можно добавлять в конце переходов, их смещения с начала раскадровки могут быть неизвестны до воспроизведения раскадровки.

Примеры

Следующий код добавляет ключевой кадр с фиксированным смещением в 0,3 секунды от ключевого кадра в начале раскадровки.

const UI_ANIMATION_SECONDS offset = 0.3;

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

Требования


Минимальная версия клиента	Windows 7, Windows Vista и Обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	uianimation.h
DLL	UIAnimation.dll