Поделиться через

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

  • Статья

Создает цикл между двумя указанными ключевыми кадрами.

Синтаксис

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

Параметры

[in] startKeyframe

Ключевой кадр, с которого начинается цикл.

[in] endKeyframe

Ключевой кадр, на котором завершается цикл. Это не должно быть возможным, чтобы endKeyframe произошло раньше в раскадровки, чем startKeyframe.

[in] repetitionCount

Количество повторов цикла; Этот параметр должен иметь значение 0 или положительное число. Используйте UI_ANIMATION_REPEAT_INDEFINITELY (-1), чтобы повторять цикл бесконечно до тех пор, пока раскадровка не будет обрезана или завершена.

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

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

Код возврата Описание
UI_E_START_KEYFRAME_AFTER_END
 Начальный ключевой кадр может происходить после завершения ключевого кадра.
UI_E_END_KEYFRAME_NOT_DETERMINED
 Возможно, не удастся определить время окончания ключевого кадра при достижении начального ключевого кадра.
UI_E_LOOPS_OVERLAP
 Две повторяющиеся части раскадровки могут перекрываться.

Комментарии

Этот метод направляет раскадровки повторно воспроизводить интервал между заданными ключевыми кадрами, прежде чем воспроизводить оставшуюся часть раскадровки. Если указано конечное число повторений, цикл всегда воспроизводит это количество раз. Если указано UI_ANIMATION_REPEAT_INDEFINITELY (-1), цикл повторяется до завершения раскадровки. В этом случае текущая итерация цикла завершается, а остальная часть раскадровки воспроизводится. Раскадровка, которая бесконечно циклически, также заканчивается, если она усекается.

Вложенные и перекрывающиеся циклы не поддерживаются.

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

Требования

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

См. также раздел

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset