Метод TextureBrush::TextureBrush(Image*,WrapMode,constRect&) (gdiplusbrush.h)

Статья
08/24/2023

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

Синтаксис

void TextureBrush(
  [in]      Image        *image,
  [in]      WrapMode     wrapMode,
  [in, ref] const Rect & dstRect
);

Параметры

[in] image

Тип: Изображение*

Указатель на объект Image , содержащий растровое изображение используемого изображения.

[in] wrapMode

Тип: WrapMode

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

[in, ref] dstRect

Тип: const Rect

Ссылка на прямоугольник, определяющий размер этой кисти текстуры и часть изображения, которая будет использоваться этой кистью текстуры. Если объект Image создается из метафайла, кисть использует все изображение, которое масштабируется в соответствии с размером кисти.

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

None

Remarks

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

Как этот конструктор использует прямоугольник dstRect с изображениями без файла

Если размеры прямоугольника dstRect меньше размеров изображения, на котором основана кисть, изображение кисти обрезается — это часть изображения. Если размеры прямоугольника dstRect равны размерам изображения, изображение кисти идентично изображению. Прямоугольник dstRect не должен включать области за пределами размеров изображения. Это приведет к непредсказуемой реакции или к ошибке во время выполнения. Например, предположим, что у вас есть изображение со значением 256 ×256 пикселей и вы создаете объект TextureBrush на основе этого изображения, передавая в качестве параметра dstRect . Кисть будет использовать левую нижнюю часть изображения. Левый нижний угол этой части также является левым нижним углом изображения. Теперь предположим, что вы создали другой объект TextureBrush на основе того же изображения, передав в качестве параметра dstRect . Обратите внимание, что самая верхняя координата этого прямоугольника — 157, а не 156. Этот прямоугольник расширяет одну единицу за пределы высоты изображения и, скорее всего, приведет к нарушению доступа.

Как этот конструктор использует прямоугольник dstRect с изображениями метафайлов

Если размеры прямоугольника dstRect отличаются от размеров изображения, изображение кисти масштабируется меньше или больше по мере необходимости в соответствии с прямоугольником. Например, предположим, что у вас есть изображение метафайла 256 ×256 пикселей и вы создаете объект TextureBrush , передавая в качестве параметра dstRect . Изображение кисти будет включать все изображение метафайла, но будет масштабировано в соответствии с кистью: оно будет сгибаться по вертикали и растягиваться по горизонтали. Если размеры прямоугольника равны размерам изображения, изображение кисти идентично изображению.

Использование этого конструктора режима оболочки

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

Требования


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