LinearGradientBrush Klasse

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

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

Quelle:

LinearGradientBrush.cs

Kapselt eine Brush mit einem linearen Farbverlauf. Diese Klasse kann nicht geerbt werden.

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

Vererbung

Object

MarshalByRefObject

Brush

LinearGradientBrush

Beispiele

Im folgenden Beispiel wird eine horizontale LinearGradientBrusherstellt; Die Farbkomponenten ändern sich linear, wenn Sie von einer horizontalen Koordinate von 0 zu einer horizontalen Koordinate von 200 wechseln. Beispielsweise weist ein Punkt, dessen erste Koordinate zwischen 0 und 200 liegt, eine blaue Komponente auf, die zwischen 0 und 255 liegt. Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert die PaintEventArgse, die ein Parameter von PaintEventHandlerist.

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)

Hinweise

Diese Klasse kapselt sowohl zweifarbige Farbverläufe als auch benutzerdefinierte Farbverläufe.

Alle linearen Farbverläufe werden entlang einer Linie definiert, die entweder durch die Breite eines Rechtecks oder durch zwei Punkte angegeben wird.

Standardmäßig ist ein linearer Farbverlauf mit zwei Farben eine gleichmäßige lineare Mischung aus der Anfangsfarbe bis zur Endfarbe entlang der angegebenen Linie. Passen Sie das Blendmuster mithilfe der Blend-Klasse, der SetSigmaBellShape Methoden oder der SetBlendTriangularShape Methoden an. Passen Sie die Richtung des Farbverlaufs an, indem Sie die LinearGradientMode Enumeration oder den Winkel im Konstruktor angeben.

Verwenden Sie die InterpolationColors-Eigenschaft, um einen Farbverlauf mit mehreren Farben zu erstellen.

Die Transform-Eigenschaft gibt eine lokale geometrische Transformation an, die auf den Farbverlauf angewendet wird.

Anmerkung

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common nur unter Windowsunterstützt.

Konstruktoren

LinearGradientBrush(Point, Point, Color, Color)	Initialisiert eine neue Instanz der LinearGradientBrush Klasse mit den angegebenen Punkten und Farben.
LinearGradientBrush(PointF, PointF, Color, Color)	Initialisiert eine neue Instanz der LinearGradientBrush Klasse mit den angegebenen Punkten und Farben.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Erstellt eine neue Instanz der LinearGradientBrush Klasse basierend auf einem Rechteck, Start- und Endfarben und ausrichtung.
LinearGradientBrush(Rectangle, Color, Color, Single)	Erstellt eine neue Instanz der LinearGradientBrush Klasse basierend auf einem Rechteck, Start- und Endfarben und einem Ausrichtungswinkel.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Erstellt eine neue Instanz der LinearGradientBrush Klasse basierend auf einem Rechteck, Start- und Endfarben und einem Ausrichtungswinkel.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Erstellt eine neue Instanz des LinearGradientBrush basierend auf einem Rechteck, Start- und Endfarben und einem Ausrichtungsmodus.
LinearGradientBrush(RectangleF, Color, Color, Single)	Erstellt eine neue Instanz der LinearGradientBrush Klasse basierend auf einem Rechteck, Start- und Endfarben und einem Ausrichtungswinkel.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Erstellt eine neue Instanz der LinearGradientBrush Klasse basierend auf einem Rechteck, Start- und Endfarben und einem Ausrichtungswinkel.

Eigenschaften

Blend	Dient zum Abrufen oder Festlegen eines Blend, der Positionen und Faktoren angibt, die einen benutzerdefinierten Falloff für den Farbverlauf definieren.
GammaCorrection	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Gammakorrektur für diese LinearGradientBrushaktiviert ist.
InterpolationColors	Dient zum Abrufen oder Festlegen eines ColorBlend, der einen linearen Farbverlauf mit mehreren Farben definiert.
LinearColors	Ruft die Anfangs- und Endfarben des Farbverlaufs ab oder legt diese fest.
Rectangle	Ruft einen rechteckigen Bereich ab, der die Anfangs- und Endpunkte des Farbverlaufs definiert.
Transform	Dient zum Abrufen oder Festlegen einer Kopie Matrix, die eine lokale geometrische Transformation für diese LinearGradientBrushdefiniert.
WrapMode	Dient zum Abrufen oder Festlegen einer WrapMode Enumeration, die den Umbruchmodus für diese LinearGradientBrushangibt.

Methoden

Clone()	Erstellt eine genaue Kopie dieses LinearGradientBrush.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle Ressourcen frei, die von diesem Brush-Objekt verwendet werden. (Geerbt von Brush)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom Brush verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Brush)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MultiplyTransform(Matrix)	Multipliziert die Matrix, die die lokale geometrische Transformation dieses LinearGradientBrush durch die angegebene Matrix darstellt, indem die angegebene Matrixvorausgestellt wird.
MultiplyTransform(Matrix, MatrixOrder)	Multipliziert die Matrix, die die lokale geometrische Transformation dieser LinearGradientBrush durch die angegebene Matrix in der angegebenen Reihenfolge darstellt.
ResetTransform()	Setzt die Transform -Eigenschaft auf Identität zurück.
RotateTransform(Single)	Dreht die lokale geometrische Transformation um den angegebenen Betrag. Mit dieser Methode wird die Drehung der Transformation vorangestellt.
RotateTransform(Single, MatrixOrder)	Dreht die lokale geometrische Transformation um den angegebenen Betrag in der angegebenen Reihenfolge.
ScaleTransform(Single, Single)	Skaliert die lokale geometrische Transformation um die angegebenen Beträge. Diese Methode stellt die Skalierungsmatrix der Transformation voran.
ScaleTransform(Single, Single, MatrixOrder)	Skaliert die lokale geometrische Transformation um die angegebenen Mengen in der angegebenen Reihenfolge.
SetBlendTriangularShape(Single)	Erstellt einen linearen Farbverlauf mit einer Mittelfarbe und einem linearen Falloff zu einer einzelnen Farbe auf beiden Enden.
SetBlendTriangularShape(Single, Single)	Erstellt einen linearen Farbverlauf mit einer Mittelfarbe und einem linearen Falloff zu einer einzelnen Farbe auf beiden Enden.
SetNativeBrush(IntPtr)	Legt in einer abgeleiteten Klasse einen Verweis auf ein GDI+-Pinselobjekt fest. (Geerbt von Brush)
SetSigmaBellShape(Single)	Erstellt einen Farbverlaufsfall basierend auf einer glockenförmigen Kurve.
SetSigmaBellShape(Single, Single)	Erstellt einen Farbverlaufsfall basierend auf einer glockenförmigen Kurve.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TranslateTransform(Single, Single)	Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran.
TranslateTransform(Single, Single, MatrixOrder)	Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen in der angegebenen Reihenfolge.

Weitere Informationen

• Vorgehensweise: Erstellen eines linearen Farbverlaufs