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

Статья
08/23/2023

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

Синтаксис

Status GetTransform(
  [out] Matrix *matrix
);

Параметры

[out] matrix

Тип: Matrix*

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

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

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

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

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

Объект LinearGradientBrush поддерживает матрицу преобразования, которая может хранить любое аффинное преобразование. При использовании кисти линейного градиента для заполнения области GDI+ преобразует границы кисти в соответствии с матрицей преобразования кисти, а затем заполняет область. Преобразованные границы существуют только во время отрисовки; Границы, хранящиеся в объекте LinearGradientBrush , не преобразуются.

Примеры

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

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.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