IDCompositionRectangleClip：：SetTop (IDCompositionAnimation*) 方法 (dcomp.h)

以動畫顯示裁剪矩形的 Top 屬性值。 Top 屬性會指定裁剪矩形左上角的 Y 座標。

語法

HRESULT SetTop(
  [in] IDCompositionAnimation *animation
);

[in] animation

動畫物件，決定 Top 屬性的值在一段時間內的變更方式。此參數不得為 Null。

類型： HRESULT

如果函式成功，它會傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼的清單，請參閱 DirectComposition 錯誤碼。

這個方法會建立指定動畫的複本。如果動畫參數所參考的物件在呼叫此方法之後有所變更，除非再次呼叫此方法，否則變更不會影響 Top 屬性。如果 Top 屬性先前是動畫，則呼叫此方法會以新的動畫取代先前的動畫。

如果動畫是不正確指標，或不是由與受影響視覺效果相同的 IDCompositionDevice 介面所建立，這個方法就會失敗。介面不能是自訂實作;只有由 Microsoft DirectComposition 建立的介面可以搭配這個方法使用。