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 |