LinearGradientBrush 類別

定義

命名空間:

System.Drawing.Drawing2D

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

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 和更新版本中，只有 Windows 作業系統才支援包含此類型的 System.Drawing.Common 套件。 在跨平臺應用程式中使用此類型會導致編譯時間警告和運行時間例外狀況。 如需詳細資訊，請參閱 僅限 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 的環繞模式。

方法

Clone()	建立這個 LinearGradientBrush 的完全相同複本。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放這個 Brush 物件使用的所有資源。 (繼承來源 Brush)
Dispose(Boolean)	釋放 Brush 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Brush)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
MultiplyTransform(Matrix)	藉由在前面加上指定的 Matrix，將表示這個 LinearGradientBrush 的局部幾何轉換的 Matrix 乘以指定的 Matrix。
MultiplyTransform(Matrix, MatrixOrder)	依據指定的順序，將表示這個 Matrix 之局部幾何轉換的 LinearGradientBrush 乘以指定的 Matrix。
ResetTransform()	將 Transform 屬性重設為識別 (Identity)。
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 線性漸層