Метод PathGradientBrush::SetWrapMode (gdipluspath.h)

Статья
08/24/2023

Метод PathGradientBrush::SetWrapMode задает режим переноса этой кисти градиента пути.

Синтаксис

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Параметры

[in] wrapMode

Тип: WrapMode

Элемент перечисления WrapMode , указывающий, каким образом области, окрашенные кистью градиента пути, будут мозаичны. Значение по умолчанию — WrapModeClamp.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Ограничивающий прямоугольник кисти градиента пути является наименьшим прямоугольником, который охватывает путь границы кисти. При закрашивание ограничивающего прямоугольника кистью градиента пути заполняется только область внутри пути границы. Область внутри ограничивающего прямоугольника, но вне пути границы не заполняется.

WrapModeClamp (режим переноса по умолчанию) указывает, что рисование не выполняется за пределами ограничивающего прямоугольника кисти. Все остальные режимы обтекания указывают, что области за пределами ограничивающего прямоугольника кисти будут мозаичными. Каждая плитка является копией (возможно, перевернутой) заполненного пути внутри ограничивающего прямоугольника.

Примеры

В следующем примере создается объект PathGradientBrush на основе треугольного пути. Код вызывает метод PathGradientBrush::SetWrapMode объекта PathGradientBrush , чтобы задать для режима переноса кисти значение 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); 
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdipluspath.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll