IDCompositionVisual：：SetOffsetX (IDCompositionAnimation*) 方法 (dcomp.h)

變更這個視覺效果的 OffsetX 屬性值。 OffsetX 屬性會指定相對於父視覺效果沿著 X 軸之視覺效果的新位移。

語法

HRESULT SetOffsetX(
  [in] IDCompositionAnimation *animation
);

[in] animation

動畫物件，決定 OffsetX 屬性的值如何隨著時間變更。此參數不得為 Null。

類型： HRESULT

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

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

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