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

Статья
08/24/2023

Метод PathGradientBrush::GetWrapMode получает режим оболочки, заданный для этой кисти градиента пути.

Синтаксис

WrapMode GetWrapMode();

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

Тип: WrapMode

Этот метод возвращает элемент перечисления WrapMode , который указывает режим переноса, заданный в данный момент для этой кисти градиента пути.

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

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

Примеры

В следующем примере создается объект PathGradientBrush на основе треугольного пути. Код вызывает метод PathGradientBrush::SetWrapMode объекта PathGradientBrush , чтобы задать для режима оболочки значение WrapModeTileFlipX. Затем код вызывает метод PathGradientBrush::GetWrapMode объекта PathGradientBrush для получения режима оболочки кисти. Если полученный режим переноса — WrapModeTileFlipX, код вызывает FillRectangle для плитки большой области с помощью кисти градиента пути.

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

   // Create a path gradient brush based on an array of points,
   // and set its wrap mode.
   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);

   // Obtain information about the path gradient brush.
   WrapMode wrapMode; 
   wrapMode = pthGrBrush.GetWrapMode();

   if(wrapMode == WrapModeTileFlipX)
         graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800);
}

Требования


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