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

Статья
08/24/2023

Метод TextureBrush::SetTransform задает матрицу преобразования этой кисти текстуры.

Синтаксис

Status SetTransform(
  [in] const Matrix *matrix
);

Параметры

[in] matrix

Тип: const Matrix*

Указатель на объект Matrix , указывающий используемую матрицу преобразования.

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

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

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

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

Объект TextureBrush поддерживает матрицу преобразования, которая может хранить любое аффинное преобразование. При использовании кисти текстуры для заполнения области Windows GDI+ преобразует изображение кисти в соответствии с матрицей преобразования кисти, а затем заполняет область. Преобразованное изображение существует только во время отрисовки; Изображение, хранящееся в объекте TextureBrush , не преобразуется. Например, предположим, что вы вызываете и затем рисуете область с помощью элемента someTextureBrush.ScaleTransform(3), а затем закрашивать область с помощью someTextureBrush. Ширина изображения кисти при закрашивается в три раза, но изображение, хранящееся в someTextureBrush , остается неизменным.

Примеры

В следующем примере создается кисть текстуры и задается преобразование кисти. Затем код использует преобразованную кисть для заполнения эллипса.

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

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&textureBrush, 0, 0, 400, 200); 
}

Требования


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