LinearGradientBrush::GetInterpolationColors 方法 (gdiplusbrush.h)

LinearGradientBrush::GetInterpolationColors 方法获取当前设置为为此线性渐变画笔插入的颜色及其相应的混合位置。

语法

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

参数

[out] presetColors

类型: 颜色*

指向接收颜色的数组的指针。 presetColors 数组中给定索引的颜色对应于 blendPositions 数组中该索引的混合位置。

[out] blendPositions

类型: REAL*

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

[in] count

类型: INT

指定 presetColors 数组中的元素数的整数。 这与 blendPositions 数组中的元素数相同。 在调用 LinearGradientBrush 对象的 LinearGradientBrush::GetInterpolationColors 方法之前,请调用同一 LinearGradientBrush 对象的 LinearGradientBrush::GetInterpolationColorCount 方法以确定当前颜色数。 检索的混合位置数与检索到的颜色数相同。

返回值

类型: 状态

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

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

要求

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

另请参阅

画笔和填充形状

颜色

创建线性渐变

使用颜色渐变填充形状

LinearGradientBrush

LinearGradientBrush::GetInterpolationColorCount

LinearGradientBrush::SetInterpolationColors

PathGradientBrush

Rect

SolidBrush