LinearGradientBrush：：GetBlend 方法 (gdiplusbrush.h)

项目
08/23/2023

LinearGradientBrush：：GetBlend 方法从 LinearGradientBrush 对象获取混合因子及其相应的混合位置。

语法

Status GetBlend(
  [out] REAL *blendFactors,
  [out] REAL *blendPositions,
  [in]  INT  count
);

参数

[out] blendFactors

类型： REAL*

指向接收混合因子的数组的指针。数组中的每个数字表示结束颜色的百分比，范围为 0.0 到 1.0。

[out] blendPositions

类型： REAL*

指向接收混合位置的数组的指针。数组中的每个数字表示起始边界和结束边界之间的距离的百分比，介于 0.0 到 1.0 之间，其中 0.0 表示渐变的起始边界，1.0 表示结束边界。介于 0.0 和 1.0 之间的混合位置表示与边界线平行的直线，即从起始边界到结束边界的距离的一定比例。例如，混合位置 0.7 表示从起始边界到结束边界的距离为 70% 的线条。在与边界线平行的线条上，颜色为常量。

[in] count

类型： INT

指定要检索的混合因子数的整数。在调用 LinearGradientBrush 对象的 LinearGradientBrush：：GetBlend 方法之前，请调用同一 LinearGradientBrush 对象的 LinearGradientBrush：：GetBlendCount 方法以确定当前混合因子的数量。检索的混合位置数与检索的混合因子数相同。

返回值

类型：状态

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

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

备注

LinearGradientBrush 对象有两个并行边界：起始边界和结束边界。颜色与这两个边界中的每一个相关联。每个边界都是一条穿过指定点的直线，起始边界穿过起点;结束边界通过终点，并垂直于线性渐变画笔的方向。线性渐变画笔的方向遵循起点和终点定义的线条。此线（即“方向线”）可以是水平、垂直或对角线。与边界平行的线条上的所有点的颜色相同。使用线性渐变画笔填充某个区域时，当沿方向线从起始边界移动到结束边界时，颜色会逐渐从一条线变为下一条线。默认情况下，颜色的变化与距离的变化成正比;也就是说，起始边界和结束边界之间距离的 30% 的线条的颜色是起始边界颜色与结束边界颜色之间的距离的 30%。颜色图案在起始和结束边界之外重复。

可以调用 LinearGradientBrush 对象的 LinearGradientBrush：：SetBlend 方法来自定义颜色和距离之间的关系。例如，假设将混合位置设置为 {0， 0.5， 1}，并将混合因子设置为 {0， 0.3， 1}。然后，起始边界和结束边界之间距离的 50% 的线条的颜色将是起始边界颜色和结束边界颜色之间距离的 30%。

示例

以下示例创建线性渐变画笔，设置其混合，并使用画笔填充矩形。然后，代码获取混合。然后，可以检查或以某种方式使用混合因子和位置。

VOID Example_GetBlend(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush, and set its blend.
   REAL fac[] = {0.0f, 0.4f, 0.6f, 1.0f};
   REAL pos[] = {0.0f, 0.2f, 0.8f, 1.0f};

   LinearGradientBrush linGrBrush(
      Point(0, 0), 
      Point(100, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlend(fac, pos, 4);

   // Use the linear gradient brush to fill a rectangle.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 100, 50);

   // Obtain information about the linear gradient brush.
   INT   blendCount;
   REAL* factors = NULL;
   REAL* positions = NULL;

   blendCount = linGrBrush.GetBlendCount();
   factors = new REAL[blendCount];
   positions = new REAL[blendCount];

   linGrBrush.GetBlend(factors, positions, blendCount);

   for(INT j = 0; j < blendCount; ++j)
   {
      // Inspect or use the value in factors[j].
      // Inspect or use the value in positions[j].
   }
}

要求


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