PathGradientBrush：：SetSurroundColors 方法 (gdipluspath.h)

项目
08/24/2023

PathGradientBrush：：SetSurroundColors 方法设置此路径渐变画笔的环绕颜色。环绕颜色是为画笔边界路径上的离散点指定的颜色。

语法

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

parameters

[in] colors

类型： const Color*

指向指定环绕颜色的 Color 对象的数组的指针。

[in, out] count

类型： INT*

指向整数的指针，该整数在输入时指定颜色数组中的 Color 对象数。如果方法成功，则此参数在输出时接收设置的环绕颜色数。如果方法失败，则此参数不会接收值。

返回值

类型：状态

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

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

注解

路径渐变画笔具有边界路径和中心点。中心点设置为单一颜色，但你可以为边界上的多个点指定不同的颜色。例如，假设你为中心颜色指定红色，并为边界上的不同点指定蓝色、绿色和黄色。然后，当你沿着边界移动时，颜色将逐渐从蓝色更改为绿色到黄色，然后返回到蓝色。当沿直线从边界上的任意点移动到中心点时，颜色将从该边界点的颜色更改为红色。

示例

以下示例基于定义三角路径的三个点数组创建 PathGradientBrush 对象。该代码还初始化三个 Color 对象的数组。调用 PathGradientBrush：：SetSurroundColors 方法会将颜色数组中的每个颜色与点数组中的相应 (相同索引) 点相关联。设置路径渐变画笔的环绕颜色后， Graphics：：FillRectangle 方法使用路径渐变画笔绘制包含三角形路径的矩形。

呈现的三角形的一个边缘逐渐从红色变为绿色。下一个边缘逐渐从绿色变为黑色，第三个边缘逐渐从黑色变为红色。代码不设置中心颜色，因此中心颜色的默认值为黑色。当沿直线从边界路径上的任意点 (三角形) 到中心点时，颜色会逐渐从该边界点的颜色变为黑色。

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

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      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);
   
   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