IDCompositionVisual：：SetOffsetX (float) 方法 (dcomp.h)

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

語法

HRESULT SetOffsetX(
  [in] float offsetX
);

參數

[in] offsetX

類型： float

沿著 X 軸的新視覺效果位移，以圖元為單位。

傳回值

類型： HRESULT

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

備註

如果 offsetX 參數為 NaN、正無限大或負無限大，這個方法就會失敗。

變更視覺效果的 OffsetX 屬性，會轉換該視覺效果根目錄之整個視覺子樹的座標系統。 如果指定這個視覺效果的 Clip 屬性，也會轉換裁剪矩形。

Transform 屬性所指定的轉換會在 OffsetX 屬性之後套用。 換句話說，設定 Transform 屬性和 OffsetX 屬性的效果與只在轉換群組物件上設定 Transform 屬性相同，其中群組的第一個成員是 IDCompositionTranslateTransform 物件，其 OffsetX 值與 offsetX相同。 不過，您應該盡可能使用 IDCompositionVisual：：SetOffsetX ，因為它稍微快一點。

如果 OffsetX 和 OffsetY 屬性設定為 0，且 Transform 屬性設定為 Null，視覺效果的座標系統會與其父系的座標系統相同。

如果先前已建立 OffsetX 屬性的動畫效果，這個方法會移除動畫，並將 屬性設定為指定的靜態值。

範例

如需範例，請參閱 如何建置簡單的視覺化樹狀結構。

需求

另請參閱

IDCompositionVisual

IDCompositionVisual：：SetOffsetY

IDCompositionVisual：：SetTransform