Class Pen

Class Pen

Nombre del espacio: Aspose.Imaging Asamblea: Aspose.Imaging.dll (25.4.0)

Define un objeto utilizado para dibujar líneas, curvas y figuras.

public class Pen : TransparencySupporter

Inheritance

object TransparencySupporter Pen

Miembros heredados

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

Examples

Este ejemplo muestra la creación y uso de los objetos de Pen. El ejemplo crea una nueva imagen y dibuja Rectangles en la superficie de la imagen.

//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)

Inicializa una nueva instancia de la clase Aspose.Imaging.Pen con el color especificado.

public Pen(Color color)

Parameters

color Color

Una estructura de Aspose.Imaging.Pen.Color que indica el color de este Aspose.Imaging.Pen.

Pen(El color, el float)

Inicializa una nueva instancia de la clase Aspose.Imaging.Pen con las propiedades especificadas Aspose.Imaging.Pen.Color y Aspose.Imaging.Pen.Width.

public Pen(Color color, float width)

Parameters

color Color

Una estructura de Aspose.Imaging.Pen.Color que indica el color de este Aspose.Imaging.Pen.

width float

Un valor que indica la anchura de este Aspose.Imaging.Pen.

Examples

Este ejemplo muestra la creación y uso de los objetos de Pen. El ejemplo crea una nueva imagen y dibuja Rectangles en la superficie de la imagen.

//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)

Inicializa una nueva instancia de la clase Aspose.Imaging.Pen con la especificada Aspose.Imaging.Pen.Brush.

public Pen(Brush brush)

Parameters

brush Brush

Un Aspose.Imaging.Pen.Brush que determina las propiedades de relleno de este Aspose.Imaging.Pen.

Exceptions

ArgumentNullException

brush’ is null.

Pen(Cortesía, Float)

Inicializa una nueva instancia de la clase Aspose.Imaging.Pen con la especificada Aspose.Imaging.Pen.Brush y Aspose.Imaging.Pen.Width.

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

Parameters

brush Brush

Un Aspose.Imaging.Pen.Brush que determina las características de este Aspose.Imaging.Pen.

width float

La amplitud del nuevo Aspose.Imaging.Pen.

Exceptions

ArgumentNullException

brush’ is null.

Properties

Alignment

Obtenga o establece la alineación para este Aspose.Imaging.Pen.

public PenAlignment Alignment { get; set; }

Valor de la propiedad

PenAlignment

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.Alignment se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

Brush

Obtenga o establece el Aspose.Imaging.Pen.Brush que determina los atributos de este Aspose.Imaging.Pen.

public Brush Brush { get; set; }

Valor de la propiedad

Brush

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.Brush se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

Color

Obtenga o establece el color de este Aspose.Imaging.Pen.

public Color Color { get; set; }

Valor de la propiedad

Color

Exceptions

ArgumentException

La propiedad Aspose.Imaging.Pen.Color se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

CompoundArray

Recibe o establece una serie de valores que especifica una pena compuesta.Una pena compuesta atrae una línea compuesta formada por líneas y espacios paralelos.

public float[] CompoundArray { get; set; }

Valor de la propiedad

float [][]

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.CompoundArray se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

CustomEndCap

Obtenga o establece una capilla personalizada para usar al final de las líneas grabadas con este Aspose.Imaging.Pen.

public CustomLineCap CustomEndCap { get; set; }

Valor de la propiedad

CustomLineCap

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.CustomEndCap está establecida en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

CustomStartCap

Obtenga o establece una captura personalizada para usar al comienzo de las líneas grabadas con este Aspose.Imaging.Pen.

public CustomLineCap CustomStartCap { get; set; }

Valor de la propiedad

CustomLineCap

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.CustomStartCap está establecida en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

DashCap

Obtenga o establece el estilo de capo utilizado al final de las columnas que forman líneas columnas tiradas con este Aspose.Imaging.Pen.

public DashCap DashCap { get; set; }

Valor de la propiedad

DashCap

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.DashCap se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

DashOffset

Obtenga o establece la distancia del comienzo de una línea al comienzo de un patrón de dash.

public float DashOffset { get; set; }

Valor de la propiedad

float

DashPattern

Obtenga o establece una serie de plazas y espacios personalizados.

public float[] DashPattern { get; set; }

Valor de la propiedad

float [][]

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.DashPattern se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

DashStyle

Obtenga o establece el estilo utilizado para las líneas encendidas grabadas con este Aspose.Imaging.Pen.

public DashStyle DashStyle { get; set; }

Valor de la propiedad

DashStyle

Exceptions

ArgumentException

La propiedad Aspose.Imaging.Pen.DashStyle se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

EndCap

Obtenga o establece el estilo de cap utilizado en el final de las líneas grabadas con este Aspose.Imaging.Pen.

public LineCap EndCap { get; set; }

Valor de la propiedad

LineCap

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.EndCap se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

LineJoin

Obtenga o establece el estilo de unión para los extremos de dos líneas consecutivas grabadas con este Aspose.Imaging.Pen.

public LineJoin LineJoin { get; set; }

Valor de la propiedad

LineJoin

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.LineJoin se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

MiterLimit

Obtenga o establece el límite de la espesor de la unión en un ángulo mediado.

public float MiterLimit { get; set; }

Valor de la propiedad

float

Exceptions

ArgumentException

La propiedad Aspose.Imaging.Pen.MiterLimit se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

PenType

Obtenga el estilo de líneas grabadas con este Aspose.Imaging.Pen.

[JsonIgnore]
public PenType PenType { get; }

Valor de la propiedad

PenType

StartCap

Obtenga o establece el estilo de cap utilizado en el comienzo de las líneas grabadas con este Aspose.Imaging.Pen.

public LineCap StartCap { get; set; }

Valor de la propiedad

LineCap

Exceptions

ArgumentException

La propiedad de Aspose.Imaging.Pen.StartCap se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

Transform

Obtenga o coloca una copia de la transformación geométrica para este Aspose.Imaging.Pen.

public Matrix Transform { get; set; }

Valor de la propiedad

Matrix

Exceptions

ArgumentException

La propiedad Aspose.Imaging.Pen.Transform se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

Width

Obtenga o establece la anchura de este Aspose.Imaging.Pen, en unidades del objeto gráfico utilizado para dibujar.

public float Width { get; set; }

Valor de la propiedad

float

Exceptions

ArgumentException

La propiedad Aspose.Imaging.Pen.Width se establece en un inmutable Aspose.Imaging.Pen, como los devueltos por la clase Aspose.Imaging.Pen.

Methods

Equals(Objeto)

Verifique si los objetos son iguales.

public override bool Equals(object obj)

Parameters

obj object

El otro objeto.

Returns

bool

El resultado de la igualdad.

Equals(Pen)

Verifique si los objetos son iguales.

protected bool Equals(Pen other)

Parameters

other Pen

El otro objeto.

Returns

bool

El resultado de la igualdad.

GetHashCode()

Obtenga el código hash del objeto actual.

public override int GetHashCode()

Returns

int

El código hash.

MultiplyTransform(Matrix)

Multiplica la matriz de transformación para este Aspose.Imaging.Pen por el especificado Aspose.Imaging.Matrix.

public void MultiplyTransform(Matrix matrix)

Parameters

matrix Matrix

El objeto Aspose.Imaging.Matrix por el que multiplicar la matriz de transformación.

MultiplyTransform(Matrix y MatrixOrder)

Multiplica la matriz de transformación para este Aspose.Imaging.Pen por el Aspose.Imaging.Matrix especificado en el orden especificado.

public void MultiplyTransform(Matrix matrix, MatrixOrder order)

Parameters

matrix Matrix

El Aspose.Imaging.Matrix por el que multiplicar la matriz de transformación.

order MatrixOrder

La orden en la que realizar la operación de multiplicación.

ResetTransform()

Resete la matriz de transformación geométrica para este Aspose.Imaging.Pen a la identidad.

public void ResetTransform()

RotateTransform(float)

Rotará la transformación geométrica local por el ángulo especificado.Este método previene la rotación a la transformación.

public void RotateTransform(float angle)

Parameters

angle float

El ángulo de la rotación.

RotateTransform(Título: MatrixOrder)

Rotará la transformación geométrica local por el ángulo especificado en el orden especificado.

public void RotateTransform(float angle, MatrixOrder order)

Parameters

angle float

El ángulo de la rotación.

order MatrixOrder

Un Aspose.Imaging.MatrixOrder que especifica si añadir o prependir la matriz de rotación.

ScaleTransform(Float y Float)

Escala la transformación geométrica local por los factores especificados.Este método previene la matriz de escalada a la transformación.

public void ScaleTransform(float sx, float sy)

Parameters

sx float

El factor por el que escalar la transformación en la dirección x-axis.

sy float

El factor por el que escalar la transformación en la dirección y-axis.

ScaleTransform(Float, Float y MatrixOrder)

Escala la transformación geométrica local por los factores especificados en el orden especificado.

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

Parameters

sx float

El factor por el que escalar la transformación en la dirección x-axis.

sy float

El factor por el que escalar la transformación en la dirección y-axis.

order MatrixOrder

Un Aspose.Imaging.MatrixOrder que especifica si añadir o prependir la matriz de escalada.

SetLineCap(Comentarios de LineCap, LineCap, DashCap)

Establece los valores que determinan el estilo de capo utilizado para las líneas de final grabadas por este Aspose.Imaging.Pen.

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

Parameters

startCap LineCap

Un Aspose.Imaging.LineCap que representa el estilo de cap para usar al comienzo de las líneas grabadas con este Aspose.Imaging.Pen.

endCap LineCap

Un Aspose.Imaging.LineCap que representa el estilo de cap para usar al final de las líneas grabadas con este Aspose.Imaging.Pen.

dashCap DashCap

Un Aspose.Imaging.LineCap que representa el estilo de cap para usar en el comienzo o fin de las líneas encendidas recogidas con este Aspose.Imaging.Pen.

TranslateTransform(Float y Float)

Traducirá la transformación geométrica local por las dimensiones especificadas.Este método prefiere la traducción a la transformación.

public void TranslateTransform(float dx, float dy)

Parameters

dx float

El valor de la traducción en x.

dy float

El valor de la traducción en y.

TranslateTransform(Float, Float y MatrixOrder)

Traducir la transformación geométrica local por las dimensiones especificadas en el orden especificado.

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

Parameters

dx float

El valor de la traducción en x.

dy float

El valor de la traducción en y.

order MatrixOrder

La orden (prepend o append) en la que aplicar la traducción.

 Español