LinearGradientBrush Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Hermetyzuje element Brush z gradientem liniowym. Klasa ta nie może być dziedziczona.

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 kolorów zmieniają się liniowo w miarę przechodzenia ze współrzędnych poziomych 0 do współrzędnych poziomych 200. Na przykład punkt, którego pierwsza współrzędna znajduje się w połowie przedziału od 0 do 200, będzie miał niebieski składnik, który znajduje się w połowie przedziału od 0 do 255. Ten przykład jest przeznaczony do użycia z Windows Forms. Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgseparametru , 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 wielobarwne.

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

Domyślnie gradient liniowy dwukolorowy to parzysta linia liniowa w poziomie od koloru początkowego do koloru końcowego wzdłuż określonej linii. Dostosuj wzorzec mieszany przy użyciu Blend klasy, SetSigmaBellShape metod lub SetBlendTriangularShape metod. Dostosuj kierunek gradientu, określając LinearGradientMode wyliczenie lub kąt w konstruktorze.

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

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

Uwaga

W programach .NET 6 i nowszych pakiet 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 only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

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

Właściwości

Blend	Pobiera lub ustawia Blend element określający pozycje i czynniki definiujące niestandardowy spadek gradientu.
GammaCorrection	Pobiera lub ustawia wartość wskazującą, czy korekta gamma jest włączona dla tego elementu LinearGradientBrush.
InterpolationColors	Pobiera lub ustawia ColorBlend element definiujący 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 elementu LinearGradientBrush.
WrapMode	Pobiera lub ustawia wyliczenie WrapMode wskazujące tryb zawijania dla tego LinearGradientBrushelementu .

Metody

Clone()	Tworzy dokładną kopię tego elementu 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 Brush obiekt. (Odziedziczone po Brush)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Brush i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Brush)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MultiplyTransform(Matrix)	Matrix Mnoży wartość reprezentującą lokalną transformację geometryczną tej LinearGradientBrush wartości przez określony Matrix przez wstępne określenie określonego Matrixelementu .
MultiplyTransform(Matrix, MatrixOrder)	Matrix Mnoży wartość reprezentującą lokalną transformację geometryczną tego LinearGradientBrush elementu przez określony Matrix w określonej kolejności.
ResetTransform()	Resetuje Transform właściwość do tożsamości.
RotateTransform(Single)	Obraca lokalną transformację geometryczną o określoną kwotę. Ta metoda poprzedza rotację 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 transformacji.
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