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

Статья
08/23/2023

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

Синтаксис

Status GetTransform(
  [out] Matrix *matrix
);

Параметры

[out] matrix

Тип: Матрица*

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

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

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

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

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

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

Примеры

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

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.GetElements(elements);

   for(INT j = 0; j <=5; ++j)
   {
      // Inspect or use the value in elements[j].
   }
}

Требования


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