IDCompositionVisual：：SetTransformParent 方法 (dcomp.h)

設定這個視覺效果的 TransformParent 屬性。 TransformParent 屬性會建立相對於這個視覺效果所撰寫的座標系統。

語法

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

參數

[in, optional] visual

類型： IDCompositionVisual*

建立這個視覺效果之基底座標系統的新視覺效果。 此參數可以是 NULL。

傳回值

類型： HRESULT

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

備註

視覺效果的座標系統是由 OffsetX、OffsetY 和 Transform 屬性修改。 一般而言，這些屬性會定義視覺效果相對於其直接父系的座標系統。 這個方法會指定相對於這個視覺效果的座標系統所依據的視覺效果。 指定的視覺效果必須是目前視覺效果的上階。 如果不是上階，則座標系統是以這個視覺效果的立即父系為基礎，就像 TransformParent 屬性設定為 NULL 一樣。 因為視覺效果可以重新親和，所以如果指定的視覺效果透過重新父代作業成為目標視覺效果的上階，這個屬性就會再次生效。

如果 視覺 參數為 NULL，則座標系統一律會相對於視覺效果的直接父系進行轉換。 如果未使用此方法，這是預設行為。

如果 視覺 參數是無效的指標，或不是由與這個視覺效果相同的 IDCompositionDevice 介面所建立，這個方法就會失敗。 介面不能是自定義實作;只有由 Microsoft DirectComposition 建立的介面可以搭配這個方法使用。

規格需求

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

另請參閱

IDCompositionVisual