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