Метод IDCompositionAnimation::End (dcompanimation.h)
Добавляет конечный сегмент, который помечает конец функции анимации.
Синтаксис
HRESULT End(
[in] double endOffset,
[in] float endValue
);
Параметры
[in] endOffset
Тип: double
Смещение (в секундах) от начала функции анимации до точки, когда функция заканчивается.
[in] endValue
Тип: float
Конечное значение анимации.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
При достижении указанного смещения свойству или свойствам, затронутым этой анимацией, присваивается заданное конечное значение, а затем анимация останавливается. Если конечный сегмент не добавляется, конечный сегмент функции анимации выполняется неограниченное время. Вызов этого метода семантически идентичен тому, чтобы сделать последний сегмент функции анимации кубическим полиномом, где кубический, квадратический и линейный коэффициенты являются нулями, а коэффициент константы является требуемым конечным значением.
Так как сегменты анимации должны добавляться в порядке увеличения, этот метод завершается ошибкой, если параметр endOffset меньше или равен параметру beginOffset предыдущего сегмента. Этот метод также завершается ошибкой, если это первый сегмент, добавляемый в функцию анимации.
После вызова этого метода все методы этого объекта анимации завершаются ошибкой, за исключением метода IDCompositionAnimation::Reset .
Требования
Минимальная версия клиента | Windows 8 [только классические приложения] |
Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
Целевая платформа | Windows |
Header | dcompanimation.h |
Библиотека | Dcomp.lib |
DLL | Dcomp.dll |