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

Статья
08/26/2023

Направляет раскадровку для планирования игры.

Синтаксис

HRESULT Schedule(
  [in]            UI_ANIMATION_SECONDS           timeNow,
  [out, optional] UI_ANIMATION_SCHEDULING_RESULT *schedulingResult
);

Параметры

[in] timeNow

Текущее время.

[out, optional] schedulingResult

Результат запроса планирования. Этот параметр можно опустить в вызовах этого метода.

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

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

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

Если этот метод вызывается из обработчика для событий OnStoryboardStatusChanged , параметру schedulingResult присваивается значение UI_ANIMATION_SCHEDULING_DEFERRED. Единственный способ определить, успешно ли запланирована раскадровка, — задать обработчик событий раскадровки и проверка, станет ли состояние раскадровки UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

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

Требования


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