LinearGradientBrush：：LinearGradientBrush (constRectF&，constColor&，constColor&，LinearGradientMode) 方法 (gdiplusbrush.h)

项目
08/23/2023

基于矩形和方向模式创建 LinearGradientBrush：：LinearGradientBrush 对象。

语法

void LinearGradientBrush(
  [in, ref] const RectF &      rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

参数

[in, ref] rect

类型： const RectF

对指定渐变起点和终点的矩形的引用。由模式指定的渐变方向会影响这些点的定义方式。矩形的尺寸会影响前向对角模式和后向对角模式的渐变方向。

[in, ref] color1

类型： const Color

对 Color 对象的引用，该对象指定此线性渐变画笔起始边界线上的颜色。

[in, ref] color2

类型： const Color

对 Color 对象的引用，该对象指定此线性渐变画笔的结束边界线上的颜色。

[in] mode

类型： LinearGradientMode

LinearGradientMode 枚举的元素，用于指定渐变的方向。

返回值

无

备注

渐变的起始边界是一条直线，通过起点或边框矩形。渐变的结束边界是一条与起始边界线平行且通过终点或边框的直线。 “方向线”是一条虚线，与边界线垂直。渐变颜色沿与边界线平行的线条不变。渐变沿方向线逐渐从起始颜色更改为结束颜色。

模式会影响渐变的边界：

垂直模式边界线与矩形矩形的顶部 (和底部) 平行。起始边界线和结束边界线分别是矩形矩形的顶部和底部。
水平模式边界线与矩形矩形的左 (和右) 平行。起始边界线和结束边界线分别是矩形矩形的左边界线和右 边界线。
前向对角模式边界线与矩形矩形右上角和左下角定义的对角线平行。起始边界线 穿过矩形矩形) 左上角 (起点。结束边界线通过矩形直角) (右下角的终点。请注意，起点和终点与后向对角模式的起始点和终点相反。
向后对角模式边界线与矩形矩形左上角和右下角定义的对角线平行。起始边界线 穿过矩形矩形) 的右上角 (起点。结束边界线通过矩形矩形) 左下角 (终点。请注意，起始点和终点与前向对角模式的起始点和终点相反。

要求


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