Метод IUIAnimationStoryboard2::AddTransitionBetweenKeyframes (uianimation.h)

Статья
03/13/2024

Добавляет переход между двумя ключевыми кадрами.

Синтаксис

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *transition,
  [in] UI_ANIMATION_KEYFRAME   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME   endKeyframe
);

Параметры

[in] variable

Переменная анимации, для которой необходимо добавить переход.

[in] transition

Добавляемый переход.

[in] startKeyframe

Ключевой кадр, указывающий начало нового перехода.

[in] endKeyframe

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

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

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

Код возврата	Описание
UI_E_TRANSITION_ALREADY_USED	Этот переход уже был добавлен в раскадровку или в раскадровку, которая завершила воспроизведение и была выпущена.
UI_E_TRANSITION_ECLIPSED	Переход может затмить начало другого перехода в раскадровки.
UI_E_START_KEYFRAME_AFTER_END	Начальный ключевой кадр может происходить после завершения ключевого кадра.

Список кодов ошибок см. в разделе Коды ошибок анимации Windows .

Этот метод применяет указанный переход к указанной переменной в раскадровки, при этом переход начинается и заканчивается указанными ключевыми кадрами. Если переход был создан с заданным параметром duration, эта длительность перезаписывается длительностью между начальным и конечным ключевыми кадрами. В противном случае анимация Windows ускоряет или замедляет переход по мере необходимости.

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

Переходы должны добавляться в том порядке, в котором они будут воспроизводиться. Переход может начаться до завершения предыдущего перехода в раскадровки. В этом случае начальное значение и скорость, видимые новым переходом, будут определяться состоянием предыдущего перехода. Переход не должен начинаться до начала предыдущего перехода.

Требования

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