IDCompositionVisual2::SetBackFaceVisibility 方法 (dcomp.h)

指定在远离观察者时是否应显示应用了 3D 转换的图面。

语法

HRESULT SetBackFaceVisibility(
  DCOMPOSITION_BACKFACE_VISIBILITY visibility
);

参数

visibility

[in]

将此视觉对象的子树中的图面组合到屏幕时使用的背面可见性。

返回值

如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 DirectComposition 错误代码。

备注

背面可见性属性会影响应用了 3D 转换的图面的呈现方式。

默认情况下,视觉对象继承其父视觉对象的后脸可见性属性,后者可能继承其父视觉对象的后脸可见性属性,依此类而行。 如果从未为视觉对象调用此方法,或者使用 DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT 调用此方法,则视觉对象将使用DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE模式。 如果没有视觉对象设置背面人脸可见性属性,则整个可视化树的默认值为DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE。

如果 可见性 参数不是DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT,则此视觉对象的图面由指定的可见性模式组成。 此外,此可见性模式将成为当前视觉对象的子级的新默认值。 也就是说,如果此视觉对象的子级的可见性模式未更改或显式设置为DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT,则子视觉对象的表面将使用此视觉对象的可见性模式进行组合。

要求

   
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

另请参阅

DirectComposition Backface 和 D2D Batching

IDCompositionEffectGroup::SetTransform3D

IDCompositionVisual2