PathGradientBrush 类

定义

命名空间:

System.Drawing.Drawing2D

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

PathGradientBrush.cs

封装 Brush 对象，它通过渐变填充 GraphicsPath 对象的内部。 此类不能被继承。

public ref class PathGradientBrush sealed : System::Drawing::Brush

public sealed class PathGradientBrush : System.Drawing.Brush

type PathGradientBrush = class
    inherit Brush

Public NotInheritable Class PathGradientBrush
Inherits Brush

继承

Object

MarshalByRefObject

Brush

PathGradientBrush

示例

下面的代码示例演示如何创建 PathGradientBrush。 此示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgs e，它是 的参数PaintEventHandler。

public void FillEllipseWithPathGradient(PaintEventArgs e)
{
    // Create a path that consists of a single ellipse.
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(0, 0, 140, 70);

    // Use the path to construct a brush.
    PathGradientBrush pthGrBrush = new PathGradientBrush(path);

    // Set the color at the center of the path to blue.
    pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255);

    // Set the color along the entire boundary 
    // of the path to aqua.
    Color[] colors = { Color.FromArgb(255, 0, 255, 255) };
    pthGrBrush.SurroundColors = colors;

    e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70);
}

' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(0, 0, 140, 70)

' Use the path to construct a brush.
Dim pthGrBrush As New PathGradientBrush(path)

' Set the color at the center of the path to blue.
pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255)

' Set the color along the entire boundary 
' of the path to aqua.
Dim colors As Color() = {Color.FromArgb(255, 0, 255, 255)}
pthGrBrush.SurroundColors = colors

e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70)

注解

颜色渐变是从路径的中心点到路径的外部边界边缘的颜色平滑着色。 混合因素、位置和样式会影响渐变的开始和结束位置，以及渐变变化阴影的速度。

路径渐变画笔不符合 SmoothingMode 用于进行绘制的 Graphics 对象的 属性。 使用 PathGradientBrush 对象填充的区域的呈现方式与 (别名) 相同，而不考虑平滑模式。

注意

在 .NET 6 及更高版本中， System.Drawing.Common 包（包括此类型）仅在 Windows 操作系统上受支持。 在跨平台应用中使用此类型会导致编译时警告和运行时异常。 有关详细信息，请参阅 System.Drawing.Common 仅在 Windows 上受支持。

构造函数

PathGradientBrush(GraphicsPath)	使用指定的路径初始化 PathGradientBrush 类的新实例。
PathGradientBrush(Point[])	使用指定的点初始化 PathGradientBrush 类的新实例。
PathGradientBrush(Point[], WrapMode)	使用指定的点和环绕模式初始化 PathGradientBrush 类的新实例。
PathGradientBrush(PointF[])	使用指定的点初始化 PathGradientBrush 类的新实例。
PathGradientBrush(PointF[], WrapMode)	使用指定的点和环绕模式初始化 PathGradientBrush 类的新实例。

属性

Blend	获取或设置一个 Blend，它指定定义渐变自定义过渡的位置和因素。
CenterColor	获取或设置路径渐变的中心处的颜色。
CenterPoint	获取或设置路径渐变的中心点。
FocusScales	获取或设置渐变过渡的焦点。
InterpolationColors	获取或设置一个定义多色线性渐变的 ColorBlend。
Rectangle	获取此 PathGradientBrush 的边框。
SurroundColors	获取或设置与此 PathGradientBrush 填充的路径中的点相对应的颜色的数组。
Transform	获取或设置一个用于定义此 Matrix 的局部几何变换的 PathGradientBrush 的副本。
WrapMode	获取或设置 WrapMode，它指示该 PathGradientBrush 的环绕模式。

方法

Clone()	创建此 PathGradientBrush 的一个精确副本。
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放由此 Brush 对象使用的所有资源。 (继承自 Brush)
Dispose(Boolean)	释放由 Brush 占用的非托管资源，还可以另外再释放托管资源。 (继承自 Brush)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
MultiplyTransform(Matrix)	通过画笔的变换矩阵与其他的矩阵相乘的乘积更新该画笔的变换矩阵。
MultiplyTransform(Matrix, MatrixOrder)	通过画笔的变换矩阵与其他的矩阵相乘的乘积更新该画笔的变换矩阵。
ResetTransform()	将 Transform 属性重置为标识。
RotateTransform(Single)	将局部几何转换旋转指定大小。 此方法预先计算对转换的旋转。
RotateTransform(Single, MatrixOrder)	将局部几何转换以指定顺序旋转指定量。
ScaleTransform(Single, Single)	将局部几何转换缩放指定的量。 此方法预先计算转换的缩放矩阵。
ScaleTransform(Single, Single, MatrixOrder)	将局部几何转换以指定顺序缩放指定的量。
SetBlendTriangularShape(Single)	创建一个从中心色向周围色线性过渡的渐变过程。
SetBlendTriangularShape(Single, Single)	创建一个从中心色向各周围色线性过渡的渐变过程。
SetNativeBrush(IntPtr)	在派生类中，设置对 GDI+ 画笔对象的引用。 (继承自 Brush)
SetSigmaBellShape(Single)	创建一个从路径中心开始向路径边界更改颜色的渐变画笔。 从一种颜色向另一种颜色的转换基于一个钟形曲线。
SetSigmaBellShape(Single, Single)	创建一个从路径中心开始向路径边界更改颜色的渐变画笔。 从一种颜色向另一种颜色的转换基于一个钟形曲线。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TranslateTransform(Single, Single)	将指定的转换应用于局部几何变换。 该方法将预先计算对转换的平移。
TranslateTransform(Single, Single, MatrixOrder)	按指定的顺序向局部几何变换应用指定的转换。

另请参阅

• 如何：Create路径渐变