Поделиться через


Метод LinearGradientBrush::SetWrapMode (gdiplusbrush.h)

Метод LinearGradientBrush::SetWrapMode задает режим оболочки для этой кисти линейного градиента.

Синтаксис

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Параметры

[in] wrapMode

Тип: WrapMode

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

  • WrapModeTile
  • WrapModeTileFlipX
  • WrapModeTileFlipY
  • WrapModeTileFlipXY

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

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

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

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

Комментарии

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

Режим оболочки по умолчанию имеет значение WrapModeTile при построении объекта LinearGradientBrush .

Примеры

В следующем примере создается линейная кисть градиента и она используется для заполнения прямоугольника. Затем код изменяет режим переноса кисти и использует измененную кисть для заполнения другого прямоугольника.

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 Профессиональная [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header gdiplusbrush.h (включая Gdiplus.h)
Библиотека Gdiplus.lib
DLL Gdiplus.dll

См. также раздел

Кисти и закрашенные фигуры

Создание линейного градиента

LinearGradientBrush;

LinearGradientBrush::GetWrapMode

Rect

Обливание фигуры с помощью изображения

WrapMode