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

變更這個視覺效果的 OffsetY 屬性值。 OffsetY 屬性會指定相對於父視覺效果的 Y 軸上視覺效果的新位移。

語法

HRESULT SetOffsetY(
  [in] float offsetY
);

參數

[in] offsetY

類型： float

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

傳回值

類型： HRESULT

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

備註

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

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

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

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

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

範例

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

需求

最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	dcomp.h
程式庫	Dcomp.lib
Dll	Dcomp.dll

另請參閱

IDCompositionVisual

IDCompositionVisual：：SetOffsetX

IDCompositionVisual：：SetTransform