Class Pen
Nome do espaço: Aspose.Imaging Assembleia: Aspose.Imaging.dll (25.4.0)
Defina um objeto usado para desenhar linhas, curvas e figuras.
public class Pen : TransparencySupporterInheritance
object ← TransparencySupporter ← Pen
Membros herdados
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
Este exemplo mostra a criação e uso de objetos Pen. O exemplo cria uma nova imagem e desenha Rectangles na superfície da imagem.
//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)
Inicia uma nova instância da classe Aspose.Imaging.Pen com a cor especificada.
public Pen(Color color)Parameters
color Color
Uma estrutura Aspose.Imaging.Pen.Color que indica a cor deste Aspose.Imaging.Pen.
Pen(Coloração, Float)
Inicializa uma nova instância da classe Aspose.Imaging.Pen com as propriedades especificadas Aspose.Imaging.Pen.Color e Aspose.Imaging.Pen.Width.
public Pen(Color color, float width)Parameters
color Color
Uma estrutura Aspose.Imaging.Pen.Color que indica a cor deste Aspose.Imaging.Pen.
width float
Um valor que indica a largura deste Aspose.Imaging.Pen.
Examples
Este exemplo mostra a criação e uso de objetos Pen. O exemplo cria uma nova imagem e desenha Rectangles na superfície da imagem.
//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 uma nova instância da classe Aspose.Imaging.Pen com a especificada Aspose.Imaging.Pen.Brush.
public Pen(Brush brush)Parameters
brush Brush
Um Aspose.Imaging.Pen.Brush que determina as propriedades de enchimento deste Aspose.Imaging.Pen.
Exceptions
brush’ is null.
Pen(Brush e Float)
Inicializa uma nova instância da classe Aspose.Imaging.Pen com a especificada Aspose.Imaging.Pen.Brush e Aspose.Imaging.Pen.Width.
[JsonConstructor]
public Pen(Brush brush, float width)Parameters
brush Brush
Um Aspose.Imaging.Pen.Brush que determina as características deste Aspose.Imaging.Pen.
width float
A extensão do novo Aspose.Imaging.Pen.
Exceptions
brush’ is null.
Properties
Alignment
Receba ou coloca o alinhamento para este Aspose.Imaging.Pen.
public PenAlignment Alignment { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.Alignment é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
Brush
Obter ou definir o Aspose.Imaging.Pen.Brush que determina os atributos deste Aspose.Imaging.Pen.
public Brush Brush { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.Brush é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
Color
Receba ou coloca a cor deste Aspose.Imaging.Pen.
public Color Color { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.Color é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
CompoundArray
Recebe ou coloca uma série de valores que especificam uma caneta de composto.A caneta de composto tira uma linha de composto composta de linhas e espaços paralelos.
public float[] CompoundArray { get; set; }Valor da propriedade
float [ ]
Exceptions
A propriedade Aspose.Imaging.Pen.CompoundArray é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
CustomEndCap
Obtenha ou coloca um capo personalizado para usar no final das linhas desenhadas com este Aspose.Imaging.Pen.
public CustomLineCap CustomEndCap { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.CustomEndCap é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
CustomStartCap
Obtenha ou coloca um capo personalizado para usar no início das linhas desenhadas com este Aspose.Imaging.Pen.
public CustomLineCap CustomStartCap { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.CustomStartCap é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
DashCap
Obtenha ou coloca o estilo de cap usado no final das colunas que compõem linhas coladas desenhadas com este Aspose.Imaging.Pen.
public DashCap DashCap { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.DashCap é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
DashOffset
Obter ou definir a distância do início de uma linha para o início de um padrão de dash.
public float DashOffset { get; set; }Valor da propriedade
DashPattern
Recebe ou coloca uma série de armadilhas e espaços personalizados.
public float[] DashPattern { get; set; }Valor da propriedade
float [ ]
Exceptions
A propriedade Aspose.Imaging.Pen.DashPattern é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
DashStyle
Obtenha ou coloque o estilo usado para linhas desenhadas com este Aspose.Imaging.Pen.
public DashStyle DashStyle { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.DashStyle é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
EndCap
Obtenha ou coloca o estilo de cap usado no final das linhas desenhadas com este Aspose.Imaging.Pen.
public LineCap EndCap { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.EndCap é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
LineJoin
Obter ou definir o estilo de adesão para os fins de duas linhas consecutivas desenhadas com este Aspose.Imaging.Pen.
public LineJoin LineJoin { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.LineJoin é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
MiterLimit
Recebe ou coloca o limite da espessura da ligação em um ângulo medido.
public float MiterLimit { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.MiterLimit é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
PenType
Obtenha o estilo de linhas desenhadas com este Aspose.Imaging.Pen.
[JsonIgnore]
public PenType PenType { get; }Valor da propriedade
StartCap
Obter ou definir o estilo de cap usado no início das linhas desenhadas com este Aspose.Imaging.Pen.
public LineCap StartCap { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.StartCap é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
Transform
Obtenha ou coloca uma cópia da transformação geométrica para este Aspose.Imaging.Pen.
public Matrix Transform { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.Transform é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
Width
Obtenha ou coloca a largura deste Aspose.Imaging.Pen, em unidades do objeto gráfico usado para desenhar.
public float Width { get; set; }Valor da propriedade
Exceptions
A propriedade Aspose.Imaging.Pen.Width é estabelecida em um imutável Aspose.Imaging.Pen, como aqueles devolvidos pela classe Aspose.Imaging.Pen.
Methods
Equals(Objeto)
Verifique se os objetos são iguais.
public override bool Equals(object obj)Parameters
obj object
O outro objeto.
Returns
O resultado da comparação da igualdade.
Equals(Pen)
Verifique se os objetos são iguais.
protected bool Equals(Pen other)Parameters
other Pen
O outro objeto.
Returns
O resultado da comparação da igualdade.
GetHashCode()
Obtenha o código hash do objeto atual.
public override int GetHashCode()Returns
O código de hash.
MultiplyTransform(Matrix)
Multiplica a matriz de transformação para este Aspose.Imaging.Pen pelo especificado Aspose.Imaging.Matrix.
public void MultiplyTransform(Matrix matrix)Parameters
matrix Matrix
O objeto Aspose.Imaging.Matrix pelo qual multiplicar a matriz de transformação.
MultiplyTransform(Título: MatrixOrder)
Multiplica a matriz de transformação para este Aspose.Imaging.Pen pelo Aspose.Imaging.Matrix especificado na ordem especificada.
public void MultiplyTransform(Matrix matrix, MatrixOrder order)Parameters
matrix Matrix
O Aspose.Imaging.Matrix pelo qual multiplicar a matriz de transformação.
order MatrixOrder
A ordem em que realizar a operação de multiplicação.
ResetTransform()
Resete a matriz de transformação geométrica para este Aspose.Imaging.Pen para a identidade.
public void ResetTransform()RotateTransform(Flotação)
Rotará a transformação geométrica local pelo ângulo especificado. este método prevê a rotação à transformação.
public void RotateTransform(float angle)Parameters
angle float
O ângulo da rotação.
RotateTransform(Armazém, MatrixOrder)
Rotará a transformação geométrica local pelo ângulo especificado na ordem especificada.
public void RotateTransform(float angle, MatrixOrder order)Parameters
angle float
O ângulo da rotação.
order MatrixOrder
Um Aspose.Imaging.MatrixOrder que especifica se adicionar ou adicionar a matriz de rotação.
ScaleTransform(Flóia, Flóia)
Escala a transformação geométrica local pelos fatores especificados.Este método prevê a matriz de escala para a transformação.
public void ScaleTransform(float sx, float sy)Parameters
sx float
O fator pelo qual escalar a transformação na direção x-axis.
sy float
O fator pelo qual escalar a transformação na direção do y-axis.
ScaleTransform(Flutão, Flutão, MatrixOrder)
Escala a transformação geométrica local pelos fatores especificados na ordem especificada.
public void ScaleTransform(float sx, float sy, MatrixOrder order)Parameters
sx float
O fator pelo qual escalar a transformação na direção x-axis.
sy float
O fator pelo qual escalar a transformação na direção do y-axis.
order MatrixOrder
Um Aspose.Imaging.MatrixOrder que especifica se adicionar ou adicionar a matriz de escalada.
SetLineCap(Título: LineCap, LineCap, DashCap)
Coloca os valores que determinam o estilo de capo usado para as linhas finais desenhadas por este Aspose.Imaging.Pen.
public void SetLineCap(LineCap startCap, LineCap endCap, DashCap dashCap)Parameters
startCap LineCap
Um Aspose.Imaging.LineCap que representa o estilo de cap para usar no início das linhas desenhadas com este Aspose.Imaging.Pen.
endCap LineCap
Um Aspose.Imaging.LineCap que representa o estilo de cap para usar no final das linhas desenhadas com este Aspose.Imaging.Pen.
dashCap DashCap
Um Aspose.Imaging.LineCap que representa o estilo de cap para ser usado no começo ou no fim de linhas desenhadas com este Aspose.Imaging.Pen.
TranslateTransform(Flóia, Flóia)
Traduz a transformação geométrica local pelas dimensões especificadas. este método prevê a tradução à transformação.
public void TranslateTransform(float dx, float dy)Parameters
dx float
O valor da tradução em x.
dy float
O valor da tradução em Y.
TranslateTransform(Flutão, Flutão, MatrixOrder)
Traduz a transformação geométrica local pelas dimensões especificadas na ordem especificada.
public void TranslateTransform(float dx, float dy, MatrixOrder order)Parameters
dx float
O valor da tradução em x.
dy float
O valor da tradução em Y.
order MatrixOrder
A ordem (prepend ou append) em que aplicar a tradução.
