PathGradientBrush：：SetWrapMode 方法 (gdipluspath.h)

PathGradientBrush：：SetWrapMode 方法设置此路径渐变画笔的环绕模式。

语法

Status SetWrapMode(
  [in] WrapMode wrapMode
);

参数

[in] wrapMode

类型： WrapMode

WrapMode 枚举的元素，指定如何使用路径渐变画笔绘制的区域平铺。 默认值为 WrapModeClamp。

返回值

类型： 状态

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

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

注解

路径渐变画笔的边框是包围画笔边界路径的最小矩形。 使用路径渐变画笔绘制边界矩形时，只会填充边界路径内的区域。 边界矩形内部但边界路径外部的区域无法填充。

WrapModeClamp (默认环绕模式) 指示画笔的边框外没有发生绘制。 所有其他环绕模式都表示画笔边界矩形外的区域将平铺。 每个磁贴都是一个副本， (可能在其边界矩形内翻转) 填充路径。

示例

以下示例基于三角路径创建 PathGradientBrush 对象。 该代码调用 PathGradientBrush 对象的 PathGradientBrush：：SetWrapModeMode 方法，以将画笔的包装模式设置为 WrapModeTileFlipX。 Graphics：：FillRectangle 方法使用路径渐变画笔平铺大面积。

代码的输出是磁贴网格。 在给定行中从一个磁贴移动到下一个磁贴时，图像 (边框内的填充边界路径) 水平翻转。

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

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800); 
}

要求

另请参阅

画笔和填充形状

创建路径渐变

使用颜色渐变填充形状

PathGradientBrush

PathGradientBrush：：GetWrapMode

PathGradientBrush：：SetWrapMode