PathGradientBrush：：SetSurroundColors 方法 (gdipluspath.h)
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 |