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 |