PathGradientBrush：：SetTransform 方法 (gdipluspath.h)

项目
02/26/2024

PathGradientBrush：：SetTransform 方法设置此路径渐变画笔的转换矩阵。

语法

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

参数

[in] matrix

类型： const Matrix*

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

返回值

类型：状态

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

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

注解

PathGradientBrush 对象具有用作画笔边界路径的 GraphicsPath 对象。使用路径渐变画笔进行绘制时，仅填充边界路径内的区域。如果画笔的转换矩阵设置为表示标识以外的任何转换，则在呈现期间根据该矩阵转换边界路径，并且仅填充转换路径中的区域。

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

示例

以下示例基于三角路径创建 PathGradientBrush 对象。 Graphics：：FillRectangle 方法使用路径渐变画笔绘制包含三角路径的矩形。接下来，代码创建一个 Matrix 对象，该对象表示复合转换 (旋转，然后转换) 并将该 Matrix 对象的地址传递给 PathGradientBrush 对象的 PathGradientBrush：：SetTransform 方法。该代码再次调用 FillRectangle ，以使用转换后的路径渐变画笔绘制同一矩形。

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

   Point pts[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);

   // Set the transformation for the brush (rotate, then translate).
   Matrix matrix(0.0f, 1.0f, -1.0f, 0.0f, 150.0f, 60.0f);
   pthGrBrush.SetTransform(&matrix);
   
   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);  
}

要求

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