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