Метод IDCompositionRotateTransform3D::SetAxisZ(IDCompositionAnimation*) (dcomp.h)
Анимирует значение свойства AxisZ преобразования трехмерного поворота. Свойство AxisZ задает Z-координату для вектора оси поворота. Значение по умолчанию — 1,0.
Синтаксис
HRESULT SetAxisZ(
[in] IDCompositionAnimation *animation
);
Параметры
[in] animation
Тип: IDCompositionAnimation*
Объект анимации, определяющий изменение значения свойства AxisZ с течением времени. Этот параметр не должен иметь значение NULL.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
При установке для оси значения, отличного от значения по умолчанию, всегда следует задавать все три свойства оси (AxisX, AxisY и AxisZ).
Этот метод создает копию указанной анимации. Если объект, на который ссылается параметр анимации , изменяется после вызова этого метода, изменение не влияет на свойство AxisZ, если этот метод не будет вызван повторно. Если свойство AxisZ было ранее анимировано, вызов этого метода заменяет предыдущую анимацию новой анимацией.
Этот метод завершается ошибкой, если анимация является недопустимым указателем или если она не была создана тем же интерфейсом IDCompositionDevice, что и затронутое трехмерное преобразование. Интерфейс не может быть пользовательской реализацией; С этим методом можно использовать только интерфейсы, созданные Microsoft DirectComposition.
Значение по умолчанию — 0.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |
См. также раздел
IDCompositionRotateTransform3D