PathGradientBrush Klasse

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

PathGradientBrush.cs

Kapselt ein Brush-Objekt, das das Innere eines GraphicsPath-Objekts mit einem Farbverlauf ausfüllt. Diese Klasse kann nicht vererbt werden.

public ref class PathGradientBrush sealed : System::Drawing::Brush

public sealed class PathGradientBrush : System.Drawing.Brush

type PathGradientBrush = class
    inherit Brush

Public NotInheritable Class PathGradientBrush
Inherits Brush

Vererbung

Object

MarshalByRefObject

Brush

PathGradientBrush

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein PathGradientBrusherstellt wird. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert das PaintEventArgs e, das ein Parameter von PaintEventHandlerist.

public void FillEllipseWithPathGradient(PaintEventArgs e)
{
    // Create a path that consists of a single ellipse.
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(0, 0, 140, 70);

    // Use the path to construct a brush.
    PathGradientBrush pthGrBrush = new PathGradientBrush(path);

    // Set the color at the center of the path to blue.
    pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255);

    // Set the color along the entire boundary 
    // of the path to aqua.
    Color[] colors = { Color.FromArgb(255, 0, 255, 255) };
    pthGrBrush.SurroundColors = colors;

    e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70);
}

' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(0, 0, 140, 70)

' Use the path to construct a brush.
Dim pthGrBrush As New PathGradientBrush(path)

' Set the color at the center of the path to blue.
pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255)

' Set the color along the entire boundary 
' of the path to aqua.
Dim colors As Color() = {Color.FromArgb(255, 0, 255, 255)}
pthGrBrush.SurroundColors = colors

e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70)

Hinweise

Der Farbverlauf ist eine glatte Schattierung der Farben vom Mittelpunkt des Pfads bis zum äußeren Rand des Pfads. Mischfaktoren, Positionen und Stil wirken sich darauf aus, wo der Farbverlauf beginnt und endet und wie schnell er den Farbton ändert.

Pfadverlaufspinsel gehorchen nicht der SmoothingMode Eigenschaft des Objekts, das Graphics zum Zeichnen verwendet wird. Bereiche, die mit einem PathGradientBrush Objekt gefüllt werden, werden unabhängig vom Glättungsmodus auf die gleiche Weise gerendert (Aliase).

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 führt zu Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

PathGradientBrush(GraphicsPath)	Initialisiert eine neue Instanz der PathGradientBrush-Klasse mit dem angegebenen Pfad.
PathGradientBrush(Point[])	Initialisiert eine neue Instanz der PathGradientBrush-Klasse mit den angegebenen Punkten.
PathGradientBrush(Point[], WrapMode)	Initialisiert eine neue Instanz der PathGradientBrush-Klasse mit den angegebenen Punkten und dem angegebenen Umbruchmodus.
PathGradientBrush(PointF[])	Initialisiert eine neue Instanz der PathGradientBrush-Klasse mit den angegebenen Punkten.
PathGradientBrush(PointF[], WrapMode)	Initialisiert eine neue Instanz der PathGradientBrush-Klasse mit den angegebenen Punkten und dem angegebenen Umbruchmodus.

Eigenschaften

Blend	Ruft einen Blend ab, der Positionen und Faktoren zum Definieren eines benutzerdefinierten Farbverlaufs angibt, oder legt diesen fest.
CenterColor	Ruft die Farbe in der Mitte des Pfadfarbverlaufs ab oder legt diese fest.
CenterPoint	Ruft den Mittelpunkt des Pfadfarbverlaufs ab oder legt diesen fest.
FocusScales	Ruft den Fokuspunkt des Farbverlaufs ab oder legt diesen fest.
InterpolationColors	Ruft einen ColorBlend ab, der einen mehrfarbigen linearen Farbverlauf definiert, oder legt diesen fest.
Rectangle	Ruft ein umgebendes Rechteck für diesen PathGradientBrush ab.
SurroundColors	Ruft ein Array von Farben ab, die den Punkten in dem von diesem PathGradientBrush ausgefüllten Pfad entsprechen, oder legt dieses Array fest.
Transform	Ruft eine Kopie der Matrix ab, die eine lokale geometrische Transformation für diesen PathGradientBrush definiert, oder legt diese fest.
WrapMode	Ruft eine WrapMode ab, die den Zeilenumbruchmodus für den PathGradientBrush angibt, oder legt diese fest.

Methoden

Clone()	Erstellt eine genaue Kopie von dieser PathGradientBrush.
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)	Aktualisiert die Transformationsmatrix des Pinsels mit dem Produkt der Multiplikation dieser Transformationsmatrix mit einer anderen Matrix.
MultiplyTransform(Matrix, MatrixOrder)	Aktualisiert die Transformationsmatrix des Pinsels mit dem Produkt der Multiplikation dieser Transformationsmatrix mit einer anderen Matrix.
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 Farbverlauf mit einer Farbe in der Mitte und einem linearen Übergang in eine Umgebungsfarbe.
SetBlendTriangularShape(Single, Single)	Erstellt einen Farbverlauf mit einer Farbe in der Mitte und einem linearen Übergang in jede Umgebungsfarbe.
SetNativeBrush(IntPtr)	Legt in einer abgeleiteten Klasse einen Verweis auf ein GDI+-Pinselobjekt fest. (Geerbt von Brush)
SetSigmaBellShape(Single)	Erstellt einen Farbverlaufspinsel, der die Farben von der Mitte des Pfads zu dessen Rand hin ändert. Der Übergang von einer Farbe in eine andere beruht auf einer Glockenkurve.
SetSigmaBellShape(Single, Single)	Erstellt einen Farbverlaufspinsel, der die Farben von der Mitte des Pfads zu dessen Rand hin ändert. Der Übergang von einer Farbe in eine andere beruht auf einer Glockenkurve.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TranslateTransform(Single, Single)	Weist der lokalen geometrischen Transformation die angegebene Verschiebung zu. Diese Methode stellt die Verschiebung der Transformation voran.
TranslateTransform(Single, Single, MatrixOrder)	Weist der lokalen geometrischen Transformation die angegebene Schiebung in der angegebenen Reihenfolge zu.

Weitere Informationen

• Vorgehensweise: Create eines Pfadverlaufs