共用方式為


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 屬性的動畫效果,這個方法會移除動畫,並將 屬性設定為指定的靜態值。

範例

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

需求

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

另請參閱

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform