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 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 的環繞模式。 |
方法
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應