LinearGradientBrush 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用线性渐变封装 Brush。 此类不能被继承。
public ref class LinearGradientBrush sealed : System::Drawing::Brush
public sealed class LinearGradientBrush : System.Drawing.Brush
type LinearGradientBrush = class
inherit Brush
Public NotInheritable Class LinearGradientBrush
Inherits Brush
- 继承
示例
以下示例创建一个水平 LinearGradientBrush;当从水平坐标 0 移动到水平坐标 200 时,颜色分量会线性变化。 例如,第一个坐标介于 0 和 200 之间的点的蓝色分量将介于 0 和 255 之间。 此示例旨在与 Windows 窗体 一起使用。 下面的代码示例旨在与 Windows 窗体 一起使用,它需要 PaintEventArgse
,它是 的参数PaintEventHandler。
public void UseHorizontalLinearGradients(PaintEventArgs e)
{
LinearGradientBrush linGrBrush = new LinearGradientBrush(
new Point(0, 10),
new Point(200, 10),
Color.FromArgb(255, 255, 0, 0), // Opaque red
Color.FromArgb(255, 0, 0, 255)); // Opaque blue
Pen pen = new Pen(linGrBrush);
e.Graphics.DrawLine(pen, 0, 10, 200, 10);
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);
}
Dim linGrBrush As New LinearGradientBrush( _
New Point(0, 10), _
New Point(200, 10), _
Color.FromArgb(255, 255, 0, 0), _
Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)
e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)
注解
此类封装双色渐变和自定义多色渐变。
所有线性渐变都沿由矩形宽度或两个点指定的线条定义。
默认情况下,双色线性渐变是沿指定线条从起始颜色到结束颜色的均匀水平线性混合。 使用 Blend 类、 SetSigmaBellShape 方法或 SetBlendTriangularShape 方法自定义混合模式。 通过在构造函数中指定 LinearGradientMode 枚举或角度来自定义渐变的方向。
InterpolationColors使用 属性创建多色渐变。
属性 Transform 指定应用于渐变的局部几何转换。
注意
在 .NET 6 及更高版本中, System.Drawing.Common 包(包括此类型)仅在 Windows 操作系统上受支持。 在跨平台应用中使用此类型会导致编译时警告和运行时异常。 有关详细信息,请参阅 仅在 Windows 上支持 System.Drawing.Common。
构造函数
LinearGradientBrush(Point, Point, Color, Color) |
使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(PointF, PointF, Color, Color) |
使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) |
根据一个矩形、起始颜色和结束颜色以及方向,创建 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(Rectangle, Color, Color, Single) |
根据一个矩形、起始颜色和结束颜色以及方向角度,创建 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) |
根据一个矩形、起始颜色和结束颜色以及方向角度,创建 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) |
根据一个矩形、起始颜色和结束颜色以及方向模式,创建 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(RectangleF, Color, Color, Single) |
根据一个矩形、起始颜色和结束颜色以及方向角度,创建 LinearGradientBrush 类的新实例。 |
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) |
根据一个矩形、起始颜色和结束颜色以及方向角度,创建 LinearGradientBrush 类的新实例。 |
属性
Blend |
获取或设置一个 Blend,它指定定义渐变自定义过渡的位置和因素。 |
GammaCorrection |
获取或设置一个值,该值指示是否为该 LinearGradientBrush 启用灰度校正。 |
InterpolationColors |
获取或设置一个定义多色线性渐变的 ColorBlend。 |
LinearColors |
获取或设置渐变的起始色和结束色。 |
Rectangle |
获取定义渐变的起点和终点的矩形区域。 |
Transform |
获取或设置一个副本 Matrix,它定义此 LinearGradientBrush 的局部几何转换。 |
WrapMode |
获取或设置 WrapMode 枚举,它指示该 LinearGradientBrush 的环绕模式。 |
方法
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈