Метод TextureBrush::TextureBrush(Image*,constRect&,constImageAttributes*) (gdiplusbrush.h)
Создает объект TextureBrush на основе изображения, определяющего прямоугольника и набора свойств изображения.
Синтаксис
void TextureBrush(
[in] Image *image,
[in, ref] const Rect & dstRect,
[in] const ImageAttributes *imageAttributes
);
Параметры
[in] image
Тип: Изображение*
Указатель на объект Image , содержащий растровое изображение используемого изображения.
[in, ref] dstRect
Тип: Rect
Ссылка на прямоугольник, определяющий размер этой кисти текстуры и часть изображения, которая будет использоваться этой кистью текстуры. Если объект Image создается из метафайла, кисть использует все изображение, которое масштабируется в соответствии с размером кисти.
[in] imageAttributes
Тип: ImageAttributes*
Необязательный элемент. Указатель на объект ImageAttributes , содержащий свойства изображения. Значение по умолчанию — NULL.
Возвращаемое значение
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 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusbrush.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |