LinearGradientBrush：：SetWrapMode 方法 (gdiplusbrush.h)

项目
08/23/2023

LinearGradientBrush：：SetWrapMode 方法设置此线性渐变画笔的环绕模式。

语法

Status SetWrapMode(
  [in] WrapMode wrapMode
);

参数

[in] wrapMode

类型： WrapMode

WrapMode 枚举的元素，指定如何使用此线性渐变画笔绘制的区域平铺。此参数的值必须是以下元素之一：

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

返回值

类型：状态

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

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

备注

线性渐变画笔的边界线形成图块。使用线性渐变画笔绘制区域时，磁贴会重复。线性渐变画笔可能具有按换行模式指定的特定方向翻转的备用平铺。翻转具有反转颜色顺序的效果。

构造 LinearGradientBrush 对象时，包装模式默认为 WrapModeTile。

示例

以下示例创建一个线性渐变画笔，并使用它来填充矩形。接下来，代码修改画笔的换行模式，并使用修改后的画笔填充另一个矩形。

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area using the gradient brush with the default wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Fill a large area using the gradient brush with the new wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

要求


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