PathGradientBrush：：SetCenterColor 方法 (gdipluspath.h)

项目
08/24/2023

PathGradientBrush：：SetCenterColor 方法设置此路径渐变画笔的中心颜色。中心颜色是画笔中心点处显示的颜色。

语法

Status SetCenterColor(
  [in, ref] const Color & color
);

参数

[in, ref] color

类型： const Color

对指定中心颜色的 Color 对象的引用。

返回值

类型：状态

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

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

注解

默认情况下，中心点是画笔边界路径的质心，但你可以将中心点设置为路径内部或外部的任何位置。

示例

以下示例基于椭圆创建 PathGradientBrush 对象。该代码调用 PathGradientBrush 对象的 PathGradientBrush：：SetCenterColor 方法，将中心颜色设置为蓝色。 PathGradientBrush：：SetSurroundColors 方法将整个边界的颜色设置为水绿色。 FillRectangle 方法使用路径渐变画笔绘制包含椭圆的矩形。

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

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300); 
}

要求

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