LinearGradientBrush Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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 , PaintEventArgse
bei dem es sich um einen Parameter von PaintEventHandlerhandelt.
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() |
Veraltet.
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() |
Veraltet.
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. |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für