Class Pen

Class Pen

Der Name: Aspose.Imaging Versammlung: Aspose.Imaging.dll (25.4.0)

Definiert ein Objekt, das zum Zeichnen von Linien, Kurven und Zahlen verwendet wird.

public class Pen : TransparencySupporter

Inheritance

object TransparencySupporter Pen

Vererbte Mitglieder

TransparencySupporter.Equals(object) , TransparencySupporter.GetHashCode() , TransparencySupporter.Equals(TransparencySupporter) , TransparencySupporter.Opacity , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Examples

Dieses Beispiel zeigt die Erstellung und Verwendung von Pen-Objekten. Das Beispiel schafft ein neues Bild und zeichnet Rectangles auf der Bildoberfläche.

//Create an instance of BmpOptions and set its various properties
                                                                                                                                       Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
                                                                                                                                       bmpOptions.BitsPerPixel = 24;

                                                                                                                                       //Create an instance of FileCreateSource and assign it as Source for the instance of BmpOptions
                                                                                                                                       //Second Boolean parameter determines if the file to be created IsTemporal or not
                                                                                                                                       bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\sample.bmp", false);

                                                                                                                                       //Create an instance of Image at specified Path
                                                                                                                                       using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
                                                                                                                                       {
                                                                                                                                           //Create an instance of Graphics and initialize it with Image object
                                                                                                                                           Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

                                                                                                                                           //Clear the Graphics sutface with White Color
                                                                                                                                           graphics.Clear(Aspose.Imaging.Color.White);

                                                                                                                                           //Create an instance of Pen with color Red and width 5
                                                                                                                                           Aspose.Imaging.Pen pen = new Aspose.Imaging.Pen(Aspose.Imaging.Color.Red, 5f);

                                                                                                                                           //Create an instance of HatchBrush and set its properties
                                                                                                                                           Aspose.Imaging.Brushes.HatchBrush brush = new Aspose.Imaging.Brushes.HatchBrush();
                                                                                                                                           brush.BackgroundColor = Aspose.Imaging.Color.Wheat;
                                                                                                                                           brush.ForegroundColor = Aspose.Imaging.Color.Red;

                                                                                                                                           //Create an instance of Pen
                                                                                                                                           //initialize it with HatchBrush object and width
                                                                                                                                           Aspose.Imaging.Pen brusedpen = new Pen(brush, 5);

                                                                                                                                           //Draw Rectangles by specifying Pen object
                                                                                                                                           graphics.DrawRectangles(pen, new[]
                                                                                                                                           {
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(210, 210), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 110), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 310), new Aspose.Imaging.Size(100, 100))
                                                                                                                                           });

                                                                                                                                           //Draw Rectangles by specifying Pen object
                                                                                                                                           graphics.DrawRectangles(brusedpen, new[]
                                                                                                                                           {
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 110), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 310), new Aspose.Imaging.Size(100, 100))
                                                                                                                                           });

                                                                                                                                           // save all changes.
                                                                                                                                           image.Save();
                                                                                                                                       }

Constructors

Pen(Color)

Initialisiert eine neue Instanz der Aspose.Imaging.Pen Klasse mit der angegebenen Farbe.

public Pen(Color color)

Parameters

color Color

Eine Aspose.Imaging.Pen.Color Struktur, die die Farbe dieses Aspose.Imaging.Pen angibt.

Pen(Farbe und Float)

Initialisiert eine neue Instanz der Aspose.Imaging.Pen Klasse mit den angegebenen Aspose.Imaging.Pen.Color und Aspose.Imaging.Pen.Width Eigenschaften.

public Pen(Color color, float width)

Parameters

color Color

Eine Aspose.Imaging.Pen.Color Struktur, die die Farbe dieses Aspose.Imaging.Pen angibt.

width float

Ein Wert, der die Breite dieses Aspose.Imaging.Pen angibt.

Examples

Dieses Beispiel zeigt die Erstellung und Verwendung von Pen-Objekten. Das Beispiel schafft ein neues Bild und zeichnet Rectangles auf der Bildoberfläche.

//Create an instance of BmpOptions and set its various properties
                                                                                                                                       Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
                                                                                                                                       bmpOptions.BitsPerPixel = 24;

                                                                                                                                       //Create an instance of FileCreateSource and assign it as Source for the instance of BmpOptions
                                                                                                                                       //Second Boolean parameter determines if the file to be created IsTemporal or not
                                                                                                                                       bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\sample.bmp", false);

                                                                                                                                       //Create an instance of Image at specified Path
                                                                                                                                       using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
                                                                                                                                       {
                                                                                                                                           //Create an instance of Graphics and initialize it with Image object
                                                                                                                                           Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

                                                                                                                                           //Clear the Graphics sutface with White Color
                                                                                                                                           graphics.Clear(Aspose.Imaging.Color.White);

                                                                                                                                           //Create an instance of Pen with color Red and width 5
                                                                                                                                           Aspose.Imaging.Pen pen = new Aspose.Imaging.Pen(Aspose.Imaging.Color.Red, 5f);

                                                                                                                                           //Create an instance of HatchBrush and set its properties
                                                                                                                                           Aspose.Imaging.Brushes.HatchBrush brush = new Aspose.Imaging.Brushes.HatchBrush();
                                                                                                                                           brush.BackgroundColor = Aspose.Imaging.Color.Wheat;
                                                                                                                                           brush.ForegroundColor = Aspose.Imaging.Color.Red;

                                                                                                                                           //Create an instance of Pen
                                                                                                                                           //initialize it with HatchBrush object and width
                                                                                                                                           Aspose.Imaging.Pen brusedpen = new Pen(brush, 5);

                                                                                                                                           //Draw Rectangles by specifying Pen object
                                                                                                                                           graphics.DrawRectangles(pen, new[]
                                                                                                                                           {
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(210, 210), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 110), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 310), new Aspose.Imaging.Size(100, 100))
                                                                                                                                           });

                                                                                                                                           //Draw Rectangles by specifying Pen object
                                                                                                                                           graphics.DrawRectangles(brusedpen, new[]
                                                                                                                                           {
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 110), new Aspose.Imaging.Size(100, 100)),
                                                                                                                                               new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 310), new Aspose.Imaging.Size(100, 100))
                                                                                                                                           });

                                                                                                                                           // save all changes.
                                                                                                                                           image.Save();
                                                                                                                                       }

Pen(Brush)

Initialisiert eine neue Instanz der Aspose.Imaging.Pen Klasse mit der angegebenen Aspose.Imaging.Pen.Brush.

public Pen(Brush brush)

Parameters

brush Brush

Ein Aspose.Imaging.Pen.Brush, der die Füllteigenschaften dieses Aspose.Imaging.Pen bestimmt.

Exceptions

ArgumentNullException

brush’ is null.

Pen(Brush und Float)

Initialisiert eine neue Instanz der Aspose.Imaging.Pen Klasse mit der angegebenen Aspose.Imaging.Pen.Brush und Aspose.Imaging.Pen.Width.

[JsonConstructor]
public Pen(Brush brush, float width)

Parameters

brush Brush

Ein Aspose.Imaging.Pen.Brush, der die Eigenschaften dieses Aspose.Imaging.Pen bestimmt.

width float

Die Breite des neuen Aspose.Imaging.Pen.

Exceptions

ArgumentNullException

brush’ is null.

Properties

Alignment

Erhalten oder setzen die Anpassung für dieses Aspose.Imaging.Pen.

public PenAlignment Alignment { get; set; }

Eigentumswert

PenAlignment

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.Alignment Eigenschaft wird auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

Brush

Gibt oder setzt die Aspose.Imaging.Pen.Brush, die die Attribute dieser Aspose.Imaging.Pen bestimmt.

public Brush Brush { get; set; }

Eigentumswert

Brush

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.Brush Eigenschaft wird auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

Color

Erhalten oder setzen die Farbe dieses Aspose.Imaging.Pen.

public Color Color { get; set; }

Eigentumswert

Color

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.Color Eigenschaft wird auf eine unveränderliche Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

CompoundArray

Er erhält oder stellt eine Reihe von Werte fest, die eine Verbindungsleiste angeben.Eine Verbindungsleiste zieht eine Verbindungslinie aus parallellen Linien und Räumen aus.

public float[] CompoundArray { get; set; }

Eigentumswert

float [][]

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.CompoundArray Eigenschaft ist auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

CustomEndCap

Gibt oder setzt eine benutzerdefinierte Kap für die Verwendung am Ende der mit diesem Aspose.Imaging.Pen entworfenen Linien.

public CustomLineCap CustomEndCap { get; set; }

Eigentumswert

CustomLineCap

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.CustomEndCap Eigenschaft befindet sich auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben werden.

CustomStartCap

Gibt oder setzt eine benutzerdefinierte Kap für den Gebrauch am Anfang der mit diesem Aspose.Imaging.Pen entworfenen Zeilen.

public CustomLineCap CustomStartCap { get; set; }

Eigentumswert

CustomLineCap

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.CustomStartCap Eigenschaft befindet sich auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben werden.

DashCap

Erhalten Sie oder setzen Sie den Cap-Stil, der am Ende der Linien verwendet wird, die mit diesem Aspose.Imaging.Pen entworfen werden.

public DashCap DashCap { get; set; }

Eigentumswert

DashCap

Exceptions

ArgumentException

Das Aspose.Imaging.Pen.DashCap Eigentum ist auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

DashOffset

Erhalten oder festlegen Sie die Entfernung vom Anfang einer Linie bis zum Anfang eines Dash-Modells.

public float DashOffset { get; set; }

Eigentumswert

float

DashPattern

Er bekommt oder setzt eine Reihe an benutzerdefinierten Dashen und Räumen.

public float[] DashPattern { get; set; }

Eigentumswert

float [][]

Exceptions

ArgumentException

Das Aspose.Imaging.Pen.DashPattern Eigentum wird auf eine unveränderliche Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

DashStyle

Erhalten Sie oder setzen Sie den Stil, der für die mit diesem Aspose.Imaging.Pen aufgeführten Linien verwendet wird.

public DashStyle DashStyle { get; set; }

Eigentumswert

DashStyle

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.DashStyle Eigenschaft befindet sich auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben werden.

EndCap

Erhalten Sie oder setzen Sie den Cap-Stil, der am Ende der mit diesem Aspose.Imaging.Pen getrockneten Linien verwendet wird.

public LineCap EndCap { get; set; }

Eigentumswert

LineCap

Exceptions

ArgumentException

Das Aspose.Imaging.Pen.EndCap Eigentum ist auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

LineJoin

Erhalten Sie oder setzen Sie den Joint-Stil für die Enden von zwei verfolgten Linien mit diesem Aspose.Imaging.Pen.

public LineJoin LineJoin { get; set; }

Eigentumswert

LineJoin

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.LineJoin Eigenschaft ist auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

MiterLimit

Er bekommt oder legt die Grenze der Dicke der Verbindung auf einem gemessenen Winkel fest.

public float MiterLimit { get; set; }

Eigentumswert

float

Exceptions

ArgumentException

Das Aspose.Imaging.Pen.MiterLimit Eigentum wird auf eine unveränderliche Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

PenType

Erhalten Sie den Stil der Linien mit diesem Aspose.Imaging.Pen.

[JsonIgnore]
public PenType PenType { get; }

Eigentumswert

PenType

StartCap

Erhalten Sie oder setzen Sie den Cap-Stil, der am Anfang der mit diesem Aspose.Imaging.Pen entworfenen Zeilen verwendet wird.

public LineCap StartCap { get; set; }

Eigentumswert

LineCap

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.StartCap Eigenschaft ist auf einem unveränderlichen Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

Transform

Erhält oder stellt eine Kopie der geometrischen Transformation für diese Aspose.Imaging.Pen.

public Matrix Transform { get; set; }

Eigentumswert

Matrix

Exceptions

ArgumentException

Die Aspose.Imaging.Pen.Transform Eigenschaft wird auf eine unveränderliche Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

Width

Erhalten oder setzen die Breite dieses Aspose.Imaging.Pen, in Einheiten des Grafikobjekts verwendet zum Zeichnen.

public float Width { get; set; }

Eigentumswert

float

Exceptions

ArgumentException

Das Aspose.Imaging.Pen.Width Eigentum wird auf eine unveränderliche Aspose.Imaging.Pen, wie diejenigen, die von der Aspose.Imaging.Pen Klasse zurückgegeben.

Methods

Equals(Objekt)

berprüfen Sie, ob die Objekte gleich sind.

public override bool Equals(object obj)

Parameters

obj object

Das andere Objekt.

Returns

bool

Das Ergebnis der Gleichberechtigung.

Equals(Pen)

berprüfen Sie, ob die Objekte gleich sind.

protected bool Equals(Pen other)

Parameters

other Pen

Das andere Objekt.

Returns

bool

Das Ergebnis der Gleichberechtigung.

GetHashCode()

Erhalten Sie den Hashcode des aktuellen Objekts.

public override int GetHashCode()

Returns

int

Der Hash Code.

MultiplyTransform(Matrix)

Multipliziert die Transformationsmatrix für diese Aspose.Imaging.Pen durch die angegebenen Aspose.Imaging.Matrix.

public void MultiplyTransform(Matrix matrix)

Parameters

matrix Matrix

Das Aspose.Imaging.Matrix Objekt, durch das die Transformation Matrix zu multiplizieren.

MultiplyTransform(Matrix und MatrixOrder)

Multipliziert die Transformationsmatrix für diese Aspose.Imaging.Pen durch die angegebenen Aspose.Imaging.Matrix in der angegebenen Reihenfolge.

public void MultiplyTransform(Matrix matrix, MatrixOrder order)

Parameters

matrix Matrix

Die Aspose.Imaging.Matrix, durch die die Transformationsmatrix multipliziert werden kann.

order MatrixOrder

Die Anordnung, in der die Vervielfältigung durchgeführt wird.

ResetTransform()

Wiederherstellen der geometrischen Transformationsmatrix für dieses Aspose.Imaging.Pen zur Identität.

public void ResetTransform()

RotateTransform(Flotte)

Rotiert die lokale geometrische Transformation durch den angegebenen Winkel. Diese Methode verhängt die Rotation an die Transformation.

public void RotateTransform(float angle)

Parameters

angle float

Der Winkel der Rotation.

RotateTransform(Flöte, MatrixOrder)

Rotiert die lokale geometrische Transformation durch den angegebenen Winkel in der angegebenen Reihenfolge.

public void RotateTransform(float angle, MatrixOrder order)

Parameters

angle float

Der Winkel der Rotation.

order MatrixOrder

Ein Aspose.Imaging.MatrixOrder, der angibt, ob die Rotationsmatrix hinzugefügt oder vorzugefügt wird.

ScaleTransform(Flotte und Flotte)

Skalieren Sie die lokale geometrische Transformation durch die angegebenen Faktoren. Diese Methode verhängt die Skalierungsmatrix an die Transformation.

public void ScaleTransform(float sx, float sy)

Parameters

sx float

Der Faktor, durch den die Transformation in der X-Axi-Richtung skaliert wird.

sy float

Der Faktor, durch den die Transformation in der Y-Axis Richtung skalieren.

ScaleTransform(Flotte, Flotte und MatrixOrder)

Skalieren Sie die lokale geometrische Transformation durch die angegebenen Faktoren in der angegebenen Reihenfolge.

public void ScaleTransform(float sx, float sy, MatrixOrder order)

Parameters

sx float

Der Faktor, durch den die Transformation in der X-Axi-Richtung skaliert wird.

sy float

Der Faktor, durch den die Transformation in der Y-Axis Richtung skalieren.

order MatrixOrder

Ein Aspose.Imaging.MatrixOrder, der angibt, ob die Skalierungsmatrix hinzugefügt oder vorzugefügt wird.

SetLineCap(LineCap, LineCap und DashCap)

Setzen Sie die Werte, die den Stil des Kaps bestimmen, der für die Endlinien verwendet wird, die von diesem Aspose.Imaging.Pen entworfen werden.

public void SetLineCap(LineCap startCap, LineCap endCap, DashCap dashCap)

Parameters

startCap LineCap

Ein Aspose.Imaging.LineCap, der den Cap-Stil darstellt, der am Anfang der mit diesem Aspose.Imaging.Pen entworfenen Zeilen verwendet wird.

endCap LineCap

Ein Aspose.Imaging.LineCap, der den Cap-Stil darstellt, der am Ende der mit diesem Aspose.Imaging.Pen getrockneten Zeilen verwendet wird.

dashCap DashCap

Ein Aspose.Imaging.LineCap, der den Cap-Stil darstellt, der am Anfang oder am Ende der mit diesem Aspose.Imaging.Pen drahteten Linien verwendet wird.

TranslateTransform(Flotte und Flotte)

bersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode verhängt die Übersetzung an die Transformation.

public void TranslateTransform(float dx, float dy)

Parameters

dx float

Der Wert der Übersetzung in x.

dy float

Der Wert der Übersetzung in y.

TranslateTransform(Flotte, Flotte und MatrixOrder)

bersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen in der angegebenen Reihenfolge.

public void TranslateTransform(float dx, float dy, MatrixOrder order)

Parameters

dx float

Der Wert der Übersetzung in x.

dy float

Der Wert der Übersetzung in y.

order MatrixOrder

Die Bestellung (prepend oder append), in der die Übersetzung angewendet werden soll.

 Deutsch