Метод IDCompositionAnimation::SetAbsoluteBeginTime (dcompanimation.h)
Задает абсолютное время запуска функции анимации.
Синтаксис
HRESULT SetAbsoluteBeginTime(
[in] LARGE_INTEGER beginTime
);
Параметры
[in] beginTime
Тип: LARGE_INTEGER
Время начала этой анимации.
Возвращаемое значение
Тип: HRESULT
Если функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
По умолчанию функция анимации запускается, когда вступает в силу первый кадр анимации. Например, если приложение создает простую функцию анимации с одним примитивом с нулевым смещением, связывает анимацию с некоторым свойством, а затем вызывает метод IDCompositionDevice::Commit , первый кадр, который включает фиксацию, образцы анимации с нулевым смещением для первого примитива.
Это означает, что фактическое время запуска по умолчанию для всех анимаций зависит от времени, когда приложение создает анимацию и вызывает Commit, до времени, которое требуется обработчику композиции для получения зафиксированных изменений. Приложение может использовать метод SetAbsoluteBeginTime для более точного управления временем начала анимации.
Этот метод не управляет тем, когда анимации вступают в силу; это влияет только на выборку анимации после запуска. Если приложение указывает точное время следующего кадра в качестве абсолютного времени начала, результат будет таким же, как и отсутствие вызова этого метода. Если указанное время начала отличается от времени следующего кадра, результат будет одним из следующих:
- Если указанное время позже времени следующего кадра, запуск анимации откладывается до указанного времени начала.
- Если указанное время раньше времени следующего кадра, начало анимации удаляется и выборка начинается в функцию анимации.
Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcompanimation.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |