LinearGradientBrush 類別

定義

命名空間:

System.Drawing.Drawing2D

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v9.0.0-preview.5.24306.5

來源:

LinearGradientBrush.cs

使用線性漸層封裝 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

繼承

Object

MarshalByRefObject

Brush

LinearGradientBrush

範例

下列範例會建立水準 LinearGradientBrush;當您從 0 的水準座標移至 200 的水準座標時，色彩元件會以線性方式變更。 例如，第一個座標介於0到200之間的點會有介於0到255之間的藍色元件。 此範例的設計目的是要與 Windows Forms 搭配使用。 下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 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 操作系統。 在跨平臺應用程式中使用此類型會導致編譯時期警告和運行時間例外狀況。 如需詳細資訊，請參閱僅支援 WindowsSystem.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的包裝模式。

方法

Clone()	建立這個 LinearGradientBrush的確切複本。
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Dispose()	釋放這個 Brush 物件所使用的所有資源。 (繼承來源 Brush)
Dispose(Boolean)	釋放 Brush 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Brush)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
MultiplyTransform(Matrix)	將代表這個 LinearGradientBrush 局部幾何轉換的 Matrix 乘以指定的 Matrix 前面加上指定的 Matrix。
MultiplyTransform(Matrix, MatrixOrder)	乘以 Matrix，這個 LinearGradientBrush 的局部幾何轉換會依指定順序的指定 Matrix。
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)	依指定的順序，轉譯指定維度的局部幾何轉換。

另請參閱

• 如何：建立線性漸層