Метод IDCompositionRectangleClip::SetTop(IDCompositionAnimation*) (dcomp.h)

Анимирует значение свойства Top прямоугольника клипа. Свойство Top задает координату Y левого верхнего угла прямоугольника клипа.

Синтаксис

HRESULT SetTop(
  [in] IDCompositionAnimation *animation
);

Параметры

[in] animation

Тип: IDCompositionAnimation*

Объект анимации, определяющий, как со временем изменяется значение свойства Top. Этот параметр не должен иметь значение NULL.

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

Тип: HRESULT

Если функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .

Комментарии

Этот метод создает копию указанной анимации. Если объект, на который ссылается параметр анимации , изменяется после вызова этого метода, изменение не влияет на свойство Top, если этот метод не будет вызван снова. Если свойство Top было ранее анимировано, вызов этого метода заменяет предыдущую анимацию новой анимацией.

Этот метод завершается ошибкой, если анимация является недопустимым указателем или если она не была создана тем же интерфейсом IDCompositionDevice, что и затронутый визуальный элемент. Интерфейс не может быть пользовательской реализацией; С этим методом можно использовать только интерфейсы, созданные Microsoft DirectComposition.

Требования

См. также раздел

IDCompositionRectangleClip