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

Статья
08/26/2023

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

Синтаксис

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

Параметры

[in] variable

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

[in] transition

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

[in] startKeyframe

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

[in] endKeyframe

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

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

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

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

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

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

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

Требования


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