Метод IUIAnimationStoryboard2::SetStoryboardEventHandler (uianimation.h)
Задает обработчик для событий раскадровки.
Синтаксис
HRESULT SetStoryboardEventHandler(
[in, optional] IUIAnimationStoryboardEventHandler2 *handler,
[in] BOOL fRegisterStatusChangeForNextAnimationEvent,
[in] BOOL fRegisterUpdateForNextAnimationEvent
);
Параметры
[in, optional] handler
Обработчик, который анимация Windows должна вызывать при возникновении событий состояния раскадровки и обновления.
Указанный объект должен реализовывать интерфейс IUIAnimationStoryboardEventHandler2 или иметь значение NULL. Дополнительные сведения см. в разделе Примечания.
[in] fRegisterStatusChangeForNextAnimationEvent
Если задано значение TRUE, регистрирует событие OnStoryboardStatusChanged и включает эти события в IUIAnimationManager2::EstimateNextEventTime, который оценивает интервал времени до следующего события анимации. Нет значения по умолчанию.
[in] fRegisterUpdateForNextAnimationEvent
Если задано значение TRUE, регистрирует событие OnStoryboardUpdated и включает эти события в IUIAnimationManager2::EstimateNextEventTime, который оценивает интервал времени до следующего события анимации. Нет значения по умолчанию.
Возвращаемое значение
В случае успешного выполнения возвращает S_OK . в противном случае — код ошибки HRESULT . Список кодов ошибок см. в статье Коды ошибок анимации Windows .
Комментарии
Передача значения NULL для параметра обработчика приводит к тому, что анимация Windows освобождает ссылку на любой объект обработчика, переданный ранее. Этот метод может быть необходим для прерывания ссылочных циклов без вызова метода IUIAnimationManager2::Shutdown .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8, Windows 7 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | uianimation.h |
| DLL | UIAnimation.dll |