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

Статья
08/24/2023

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

Синтаксис

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Параметры

[in] wrapMode

Тип: WrapMode

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

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

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

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

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

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

Кисть текстуры всегда ориентирована на (0, 0). Если для режима оболочки задано значение WrapModeClamp, область за пределами кисти не будет мозаична. Например, предположим, что вы создали кисть текстуры, указав WrapModeClamp в качестве режима переноса:

TextureBrush(&SomeImage, WrapModeClamp)

Затем вы закрасите область с помощью кисти. Если размер кисти имеет высоту 50, а окрашенная область представляет собой прямоугольник с верхним левым углом в (0, 50), вы не увидите повторяющиеся копии кисти (без плитки).

Режим переноса по умолчанию для кисти текстуры — WrapModeTile, который не указывает на отсутствие переворачивания плитки и не зажимания.

Примеры

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

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

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

Требования


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