LinearGradientBrush Klasse

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

LinearGradientBrush.cs

Kapselt ein Brush-Objekt mit einem linearen Farbverlauf. Diese Klasse kann nicht vererbt 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. Bei einem Punkt, dessen erste Koordinate auf halbem Weg zwischen 0 und 200 liegt, liegt die blaue Komponente mitten zwischen 0 und 255. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert , PaintEventArgsewas 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 mehrfarbige 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 zweifarbiger linearer Farbverlauf eine gleichmäßige horizontale lineare Mischung von der Startfarbe zur Endfarbe entlang der angegebenen Linie. Passen Sie das Blendmuster mithilfe der Blend -Klasse, der SetSigmaBellShape -Methoden oder der -Methoden an SetBlendTriangularShape . 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 mehrfarbigen Farbverlauf zu erstellen.

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

Hinweis

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 verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstü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 anhand eines Rechtecks, der Anfangs- und Endfarben sowie der Ausrichtung.
LinearGradientBrush(Rectangle, Color, Color, Single)	Erstellt eine neue Instanz der LinearGradientBrush-Klasse anhand eines Rechtecks, der Anfangs- und Endfarben sowie eines Ausrichtungswinkels.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Erstellt eine neue Instanz der LinearGradientBrush-Klasse anhand eines Rechtecks, der Anfangs- und Endfarben sowie eines Ausrichtungswinkels.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Erstellt eine neue Instanz von LinearGradientBrush anhand eines Rechtecks, der Anfangs- und Endfarben sowie eines Ausrichtungsmodus.
LinearGradientBrush(RectangleF, Color, Color, Single)	Erstellt eine neue Instanz der LinearGradientBrush-Klasse anhand eines Rechtecks, der Anfangs- und Endfarben sowie eines Ausrichtungswinkels.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Erstellt eine neue Instanz der LinearGradientBrush-Klasse anhand eines Rechtecks, der Anfangs- und Endfarben sowie eines Ausrichtungswinkels.

Eigenschaften

Blend	Ruft einen Blend ab, der Positionen und Faktoren zum Definieren eines benutzerdefinierten Farbverlaufs angibt, oder legt diesen fest.
GammaCorrection	Ruft einen Wert ab, der angibt, ob die Gammakorrektur für das LinearGradientBrush-Objekt aktiviert ist, oder legt diesen fest.
InterpolationColors	Ruft einen ColorBlend ab, der einen mehrfarbigen linearen Farbverlauf definiert, oder legt diesen fest.
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	Ruft eine Kopie der Matrix ab, die eine lokale geometrische Transformation für diesen LinearGradientBrush definiert, oder legt diese fest.
WrapMode	Ruft eine WrapMode-Enumeration ab, die den Umbruchmodus für den LinearGradientBrush angibt, oder legt diese fest.

Methoden

Clone()	Erstellt eine genaue Kopie von dieser LinearGradientBrush.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle von diesem Brush-Objekt verwendeten Ressourcen frei. (Geerbt von Brush)
Dispose(Boolean)	Gibt die von Brush verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Brush)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des 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 darstellt, mit der angegebenen Matrix, indem die angegebene Matrix vorangestellt wird.
MultiplyTransform(Matrix, MatrixOrder)	Multipliziert das die geometrische Transformation des Matrix-Objekts darstellende LinearGradientBrush-Objekt mit der angegebenen Matrix in der angegebenen Reihenfolge.
ResetTransform()	Setzt die Transform-Eigenschaft auf Identität zurück.
RotateTransform(Single)	Dreht die lokale geometrische Transformation um den angegebenen Betrag. Diese Methode stellt der Transformation die Rotation voran.
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 der Transformation die Skalierungsmatrix voran.
ScaleTransform(Single, Single, MatrixOrder)	Skaliert die lokale geometrische Transformation um die angegebenen Beträge in der angegebenen Reihenfolge.
SetBlendTriangularShape(Single)	Erstellt einen linearen Farbverlauf mit einer Farbe in der Mitte und einem linearen Übergang in eine einzelne Farbe an beiden Enden.
SetBlendTriangularShape(Single, Single)	Erstellt einen linearen Farbverlauf mit einer Farbe in der Mitte und einem linearen Übergang in eine einzelne Farbe an beiden Enden.
SetNativeBrush(IntPtr)	Legt in einer abgeleiteten Klasse einen Verweis auf ein GDI+-Pinselobjekt fest. (Geerbt von Brush)
SetSigmaBellShape(Single)	Erstellt einen Farbverlaufsübergang in Form einer Glockenkurve.
SetSigmaBellShape(Single, Single)	Erstellt einen Farbverlaufsübergang in Form einer Glockenkurve.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TranslateTransform(Single, Single)	Verschiebt die lokale geometrische Transformation um die angegebenen Abmessungen. Diese Methode stellt die Verschiebung der Transformation voran.
TranslateTransform(Single, Single, MatrixOrder)	Verschiebt die lokale geometrische Transformation in der angegebenen Reihenfolge um die angegebenen Abmessungen.

Weitere Informationen

• Vorgehensweise: Erstellen eines linearen Farbverlaufs