LinearGradientBrush：：SetBlend 方法 (gdiplusbrush.h)
LinearGradientBrush：：SetBlend 方法设置此线性渐变画笔的混合因子和混合位置，以创建自定义混合。
语法
Status SetBlend(
[in] const REAL *blendFactors,
[in] const REAL *blendPositions,
[in] INT count
);
参数
[in] blendFactors
类型： const REAL*
指向指定混合因子的实数数组的指针。 数组中的每个数字指定结束颜色的百分比，应介于 0.0 到 1.0 之间。
[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
指定 blendFactors 数组中的元素数的整数。 这与 blendPositions 数组中的元素数相同。 给定数组索引处的混合因子对应于同一数组索引处的混合位置。
返回值
类型： 状态
如果该方法成功，则返回 Ok，这是 Status 枚举的元素。
如果方法失败，它将返回 Status 枚举的其他元素之一。
备注
LinearGradientBrush 对象有两个边界。 使用线性渐变画笔填充区域时，从起始边界移动到结束边界时，颜色会逐渐变化。 默认情况下，颜色与距离呈线性相关，但可以通过调用 LinearGradientBrush：：SetBlend 方法自定义颜色与距离之间的关系。
示例
以下示例创建线性渐变画笔，设置自定义混合，并使用画笔填充矩形。
VOID Example_SetBlend(HDC hdc)
{
Graphics myGraphics(hdc);
REAL factors[4] = {0.0f, 0.4f, 0.6f, 1.0f};
REAL positions[4] = {0.0f, 0.2f, 0.8f, 1.0f};
Rect rect(0, 0, 100, 50);
LinearGradientBrush linGrBrush(
rect,
Color(255, 255, 0, 0), // red
Color(255, 0, 0, 255), // blue
LinearGradientModeHorizontal);
linGrBrush.SetBlend(factors, positions, 4);
myGraphics.FillRectangle(&linGrBrush, rect);
}
要求
| 最低受支持的客户端 | Windows XP、Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | gdiplusbrush.h (包括 Gdiplus.h) |
| Library | Gdiplus.lib |
| DLL | Gdiplus.dll |