LinearGradientBrush::SetInterpolationColors 方法 (gdiplusbrush.h)

LinearGradientBrush::SetInterpolationColors 方法设置要为此线性渐变画笔及其相应的混合位置内插的颜色。

语法

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

参数

[in] presetColors

类型: const Color*

指向 Color 对象数组的指针,该对象指定要为此线性渐变画笔内插的颜色。 presetColors 数组中给定索引的颜色对应于 blendPositions 数组中同一索引的混合位置。

[in] blendPositions

类型: const REAL*

指向指定混合位置的实数数组的指针。 数组中的每个数字指定起始边界和结束边界之间的距离的百分比,介于 0.0 到 1.0 之间,其中 0.0 表示渐变的起始边界,1.0 表示结束边界。 必须至少指定两个位置:第一个位置(始终为 0.0f)和最后一个位置(始终为 1.0f)。 否则,行为未定义。 介于 0.0 和 1.0 之间的混合位置指示与边界线平行的线条,即从起始边界到结束边界距离的一定比例。 例如,混合位置 0.7 表示从起始边界到结束边界的距离为 70% 的线条。 在与边界线平行的线条上,颜色为常量。

[in] count

类型: INT

指定 presetColors 数组中的元素数的整数。 这与 blendPositions 数组中的元素数相同。

返回值

类型: 状态

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

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

要求

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

另请参阅

画笔和填充形状

颜色

创建线性渐变

使用颜色渐变填充形状

LinearGradientBrush

LinearGradientBrush::GetInterpolationColors