TextureBrush::SetWrapMode 方法 (gdiplusbrush.h)

TextureBrush::SetWrapMode 方法设置此纹理画笔的环绕模式。

语法

Status SetWrapMode(
  [in] WrapMode wrapMode
);

parameters

[in] wrapMode

类型: WrapMode

WrapMode 枚举的元素,指定使用此纹理画笔绘制区域时如何使用图像的重复副本来平铺区域。

返回值

类型: 状态

如果该方法成功,则返回 Ok,这是 Status 枚举的元素。

如果方法失败,它将返回 Status 枚举的其他元素之一。

注解

超出画笔边界的区域使用画笔的重复副本平铺。 纹理画笔可能具有按换行模式指定的特定方向翻转的备用磁贴。 翻转具有反转画笔图像的效果。 例如,如果将环绕模式指定为 WrapModeTileFlipX,则画笔将绕与 y 轴平行的线条翻转。

纹理画笔始终面向 (0, 0) 。 如果将环绕模式指定为 WrapModeClamp,则画笔外部不会平铺任何区域。 例如,假设创建一个纹理画笔,将 WrapModeClamp 指定为环绕模式:

TextureBrush(&SomeImage, WrapModeClamp)

然后,使用画笔绘制区域。 如果画笔的大小高度为 50,并且绘制的区域是左上角位于 (0、50) 的矩形,则不会看到画笔的重复副本 (没有平铺) 。

纹理画笔的默认环绕模式为 WrapModeTile,它指定不翻转平铺和固定。

示例

以下示例创建纹理画笔,设置画笔的环绕模式,并使用画笔填充矩形。

VOID Example_SetWrapMode(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusbrush.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

画笔和填充形状

使用图像纹理填充形状

TextureBrush

TextureBrush::GetWrapMode

使用图像平铺形状

WrapMode