LinearGradientBrush：：SetTransform 方法 (gdiplusbrush.h)

项目
08/23/2023

LinearGradientBrush：：SetTransform 方法设置此线性渐变画笔的转换矩阵。

语法

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

参数

[in] matrix

类型： const Matrix*

指向 Matrix 对象的指针，该对象指定转换矩阵。

返回值

类型：状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

LinearGradientBrush 对象具有一个矩形，该矩形指定渐变的起始和结束边界，以及影响方向的模式或角度。如果画笔的转换矩阵设置为表示除标识以外的任何转换，则在呈现期间根据该矩阵转换边界和方向。

转换仅在呈现期间应用。 LinearGradientBrush：：SetTransform 方法不会更改 LinearGradientBrush 对象存储的边界。

示例

以下示例创建一个线性渐变画笔，并使用它来填充矩形。接下来，代码修改画笔的转换矩阵，并使用转换后的画笔填充矩形。

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   Matrix matrix(2.0, 0, 0, 1, 0, 0);  // horizontal doubling

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetTransform(&matrix);

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

要求

要求	值
最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusbrush.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll