LinearGradientBrush Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

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

Źródło:

LinearGradientBrush.cs

Hermetyzuje Brush z gradientem liniowym. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

MarshalByRefObject

Brush

LinearGradientBrush

Przykłady

Poniższy przykład tworzy poziome LinearGradientBrush; składniki koloru zmieniają się liniowo w miarę przechodzenia ze współrzędnej poziomej 0 do współrzędnej poziomej 200. Na przykład punkt, którego pierwsza współrzędna znajduje się w połowie zakresu od 0 do 200, będzie miał niebieski składnik, który znajduje się w połowie zakresu od 0 do 255. Ten przykład jest przeznaczony do użycia z formularzami systemu Windows. Poniższy przykład kodu jest przeznaczony do użycia z windows Forms i wymaga PaintEventArgse, który jest parametrem 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)

Uwagi

Ta klasa hermetyzuje zarówno gradienty dwukolorowe, jak i niestandardowe gradienty wielokolorowe.

Wszystkie gradienty liniowe są definiowane wzdłuż linii określonej przez szerokość prostokąta lub dwa punkty.

Domyślnie gradient liniowy dwukolorowy jest parzystą liniową mieszanką poziomą od koloru początkowego do koloru końcowego wzdłuż określonej linii. Dostosuj wzorzec mieszania przy użyciu klasy Blend, metod SetSigmaBellShape lub metod SetBlendTriangularShape. Dostosuj kierunek gradientu, określając LinearGradientMode wyliczenie lub kąt w konstruktorze.

Użyj właściwości InterpolationColors, aby utworzyć gradient wielokolorowy.

Właściwość Transform określa lokalną transformację geometryczną zastosowaną do gradientu.

Nuta

W wersjach .NET 6 i nowszych System.Drawing.Common, który zawiera ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common obsługiwane tylko w systemie Windows.

Konstruktory

LinearGradientBrush(Point, Point, Color, Color)	Inicjuje nowe wystąpienie klasy LinearGradientBrush z określonymi punktami i kolorami.
LinearGradientBrush(PointF, PointF, Color, Color)	Inicjuje nowe wystąpienie klasy LinearGradientBrush z określonymi punktami i kolorami.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Tworzy nowe wystąpienie klasy LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz orientacji.
LinearGradientBrush(Rectangle, Color, Color, Single)	Tworzy nowe wystąpienie klasy LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz kąta orientacji.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Tworzy nowe wystąpienie klasy LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz kąta orientacji.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Tworzy nowe wystąpienie LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz trybu orientacji.
LinearGradientBrush(RectangleF, Color, Color, Single)	Tworzy nowe wystąpienie klasy LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz kąta orientacji.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Tworzy nowe wystąpienie klasy LinearGradientBrush na podstawie prostokąta, kolorów początkowych i końcowych oraz kąta orientacji.

Właściwości

Blend	Pobiera lub ustawia Blend, który określa pozycje i czynniki definiujące niestandardowy spadek gradientu.
GammaCorrection	Pobiera lub ustawia wartość wskazującą, czy dla tej LinearGradientBrushjest włączona korekta gamma.
InterpolationColors	Pobiera lub ustawia ColorBlend definiującą gradient liniowy wielobarwny.
LinearColors	Pobiera lub ustawia kolory początkowe i końcowe gradientu.
Rectangle	Pobiera prostokątny region, który definiuje punkty początkowe i końcowe gradientu.
Transform	Pobiera lub ustawia kopię Matrix definiującą lokalną transformację geometryczną dla tego LinearGradientBrush.
WrapMode	Pobiera lub ustawia wyliczenie WrapMode wskazujące tryb zawijania dla tego LinearGradientBrush.

Metody

Clone()	Tworzy dokładną kopię tego LinearGradientBrush.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten obiekt Brush. (Odziedziczone po Brush)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez Brush i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po Brush)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject. (Odziedziczone po MarshalByRefObject)
MultiplyTransform(Matrix)	Mnoży Matrix reprezentującą lokalną transformację geometryczną tego LinearGradientBrush przez określony Matrix przez poprzedzanie określonego Matrix.
MultiplyTransform(Matrix, MatrixOrder)	Mnoży Matrix reprezentującą lokalną transformację geometryczną tego LinearGradientBrush przez określony Matrix w określonej kolejności.
ResetTransform()	Resetuje właściwość Transform do tożsamości.
RotateTransform(Single)	Obraca lokalną transformację geometryczną o określoną kwotę. Ta metoda poprzedza rotację do przekształcenia.
RotateTransform(Single, MatrixOrder)	Obraca lokalną transformację geometryczną o określoną kwotę w określonej kolejności.
ScaleTransform(Single, Single)	Skaluje lokalną transformację geometryczną według określonych kwot. Ta metoda poprzedza macierz skalowania do przekształcenia.
ScaleTransform(Single, Single, MatrixOrder)	Skaluje lokalną transformację geometryczną według określonych kwot w określonej kolejności.
SetBlendTriangularShape(Single)	Tworzy gradient liniowy z kolorem środkowym i spadkiem liniowym na jeden kolor na obu końcach.
SetBlendTriangularShape(Single, Single)	Tworzy gradient liniowy z kolorem środkowym i spadkiem liniowym na jeden kolor na obu końcach.
SetNativeBrush(IntPtr)	W klasie pochodnej ustawia odwołanie do obiektu pędzla GDI+ . (Odziedziczone po Brush)
SetSigmaBellShape(Single)	Tworzy spadek gradientu na podstawie krzywej w kształcie dzwonu.
SetSigmaBellShape(Single, Single)	Tworzy spadek gradientu na podstawie krzywej w kształcie dzwonu.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TranslateTransform(Single, Single)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów. Ta metoda poprzedza tłumaczenie przekształcenia.
TranslateTransform(Single, Single, MatrixOrder)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów w określonej kolejności.

Zobacz też

• Instrukcje: tworzenie gradientu liniowego