LinearGradientBrush：：GetTransform 方法 (gdiplusbrush.h)

项目
08/23/2023

LinearGradientBrush：：GetTransform 方法获取此线性渐变画笔的转换矩阵。

语法

Status GetTransform(
  [out] Matrix *matrix
);

参数

[out] matrix

类型：矩阵*

指向接收转换矩阵的 Matrix 对象的指针。

返回值

类型：状态

如果方法成功，则返回 Ok，这是 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 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusbrush.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll