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

Статья
08/24/2023

Метод TextureBrush::ResetTransform сбрасывает матрицу преобразования этой кисти текстуры в матрицу идентификации. Это означает, что преобразование не выполняется.

Синтаксис

Status ResetTransform();

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

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

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

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

Установка матрицы преобразования в матрицу удостоверений гарантирует, что преобразование не будет выполнено. Этот метод часто используется для сброса преобразования перед внесением в него каких-либо корректировок (масштабирование, поворот и т. д.).

Примеры

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

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

   // Create a texture brush, and set its transformation.
   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.RotateTransform(30);

   // Fill a rectangle with the transformed texture brush.
   graphics.FillRectangle(&textureBrush, 0, 0, 200, 100);

   textureBrush.ResetTransform();
   
   // Fill a rectangle with the texture brush (no transformation).
   graphics.FillRectangle(&textureBrush, 250, 0, 200, 100);
}

Требования

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