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
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
brush’ is null.
Properties
Alignment
Erhalten oder setzen die Anpassung für dieses Aspose.Imaging.Pen.
public PenAlignment Alignment { get; set; }
Eigentumswert
Exceptions
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
Exceptions
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
Exceptions
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
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
Exceptions
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
Exceptions
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
Exceptions
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
DashPattern
Er bekommt oder setzt eine Reihe an benutzerdefinierten Dashen und Räumen.
public float[] DashPattern { get; set; }
Eigentumswert
float [][]
Exceptions
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
Exceptions
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
Exceptions
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
Exceptions
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
Exceptions
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
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
Exceptions
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
Exceptions
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
Exceptions
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
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
Das Ergebnis der Gleichberechtigung.
GetHashCode()
Erhalten Sie den Hashcode des aktuellen Objekts.
public override int GetHashCode()
Returns
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.