IDCompositionVisual::SetBorderMode 方法 (dcomp.h)

设置 BorderMode 属性,该属性指定如何组合与此视觉对象关联的位图和剪辑的边缘,或与此视觉对象根位于此视觉对象的子树中的视觉对象。

语法

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

参数

[in] borderMode

类型: DCOMPOSITION_BORDER_MODE

要使用的边框模式。

返回值

类型: HRESULT

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

备注

边框模式会影响在转换位图时位图边缘的组成方式,使边缘不完全与轴对齐且位于精确的像素边界处。 它还会影响内容在具有圆角的剪辑的角处以及经过转换的剪辑边缘的内容剪裁方式,以便边缘不完全轴对齐且位于精确的像素边界上。

默认情况下,视觉对象继承其父视觉对象的边框模式,后者可能会继承其父视觉对象的边框模式,等等。 如果从未为视觉对象调用此方法,或者如果使用 DCOMPOSITION_BORDER_MODE_INHERIT调用此方法,则视觉对象将使用默认边框模式。 如果没有视觉对象设置边框模式,则整个视觉树的默认值为别名呈现,它提供最低视觉质量,但性能最高。

如果 borderMode 参数不是 DCOMPOSITION_BORDER_MODE_INHERIT,则此视觉对象的位图和剪辑将采用指定的边框模式组成。 此外,此边框模式将成为当前视觉对象的子级的新默认值。 也就是说,如果此视觉对象的子级的边框模式保持不变或显式设置为 DCOMPOSITION_BORDER_MODE_INHERIT,则子视觉对象的位图和剪辑将使用此视觉对象的边框模式组成。

要求

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

另请参阅

IDCompositionVisual