LinearGradientBrush 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用線性漸層封裝 Brush。 無法繼承這個類別。
public ref class LinearGradientBrush sealed : System::Drawing::Brushpublic sealed class LinearGradientBrush : System.Drawing.Brushtype LinearGradientBrush = class
inherit BrushPublic NotInheritable Class LinearGradientBrush
Inherits Brush- 繼承
範例
下列範例會建立水準 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 操作系統。 在跨平臺應用程式中使用此類型會導致編譯時期警告和運行時間例外狀況。 如需詳細資訊，請參閱僅支援 Windows
建構函式
| 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的包裝模式。 |
