Share via


IDCompositionVisual::SetTransform (constD2D_MATRIX_3X2_F&) 方法 (dcomp.h)

將這個視覺效果的 Transform 屬性設定為指定的 3-by-2 轉換矩陣。

語法

HRESULT SetTransform(
  [in, ref] const D2D_MATRIX_3X2_F & matrix
);

參數

[in, ref] matrix

類型: const D2D_MATRIX_3X2_F

用來修改此視覺效果座標系統的 3-by-2 轉換矩陣。

傳回值

類型: HRESULT

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

備註

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

如果先前指定轉換物件的 Transform 屬性,則新指定的轉換矩陣會取代轉換物件。

規格需求

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

另請參閱

IDCompositionMatrixTransform

IDCompositionRotateTransform

IDCompositionScaleTransform

IDCompositionSkewTransform

IDCompositionTransform

IDCompositionTranslateTransform

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetOffsetY