Pen Clase

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Source:

Pen.cs

Define un objeto usado para dibujar líneas y curvas. Esta clase no puede heredarse.

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable

public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable

type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable

Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable

Herencia

Object

MarshalByRefObject

Pen

Implementaciones

ICloneable IDisposable

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un Pen objeto con Brush y los efectos de establecer la LineJoin propiedad en un Pen.

Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al ShowLineJoin método al controlar el evento del Paint formulario, pasando e como PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Comentarios

Un Pen dibuja una línea de ancho y estilo especificados. Utilice la DashStyle propiedad para dibujar varias variedades de líneas discontinuas. La línea dibujada por un Pen se puede rellenar en una variedad de estilos de relleno, incluidos colores sólidos y texturas. El estilo de relleno depende del pincel o textura que se usa como objeto de relleno.

Nota:

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).

Constructores

Nombre	Description
Pen(Brush, Single)	Inicializa una nueva instancia de la Pen clase con los valores especificados Brush y Width.
Pen(Brush)	Inicializa una nueva instancia de la Pen clase con el especificado Brush.
Pen(Color, Single)	Inicializa una nueva instancia de la Pen clase con las propiedades y Width especificadasColor.
Pen(Color)	Inicializa una nueva instancia de la Pen clase con el color especificado.

Propiedades

Nombre	Description
Alignment	Obtiene o establece la alineación de este Penobjeto .
Brush	Obtiene o establece el Brush objeto que determina los atributos de este Penobjeto .
Color	Obtiene o establece el color de este Penobjeto .
CompoundArray	Obtiene o establece una matriz de valores que especifica un lápiz compuesto. Un lápiz compuesto dibuja una línea compuesta formada por líneas y espacios paralelos.
CustomEndCap	Obtiene o establece un límite personalizado que se usará al final de las líneas dibujadas con este Pen.
CustomStartCap	Obtiene o establece un límite personalizado que se usará al principio de las líneas dibujadas con este Pen.
DashCap	Obtiene o establece el estilo de límite usado al final de los guiones que componen líneas discontinuas dibujadas con este Pen.
DashOffset	Obtiene o establece la distancia desde el inicio de una línea hasta el principio de un patrón de guiones.
DashPattern	Obtiene o establece una matriz de guiones y espacios personalizados.
DashStyle	Obtiene o establece el estilo usado para las líneas discontinuas dibujadas con este Pen.
EndCap	Obtiene o establece el estilo de límite usado al final de las líneas dibujadas con este Pen.
LineJoin	Obtiene o establece el estilo de combinación para los extremos de dos líneas consecutivas dibujadas con este Pen.
MiterLimit	Obtiene o establece el límite del grosor de la combinación en una esquina miterada.
PenType	Obtiene el estilo de las líneas dibujadas con este Pen.
StartCap	Obtiene o establece el estilo de límite usado al principio de las líneas dibujadas con este Pen.
Transform	Obtiene o establece una copia de la transformación geométrica de este Penobjeto .
Width	Obtiene o establece el ancho de , Penen unidades del Graphics objeto utilizado para dibujar.

Métodos

Nombre	Description
Clone()	Crea una copia exacta de este Penobjeto .
Dispose()	Libera todos los recursos usados por este Pen.
Finalize()	Permite a un objeto intentar liberar recursos y realizar otras operaciones de limpieza antes de que la recolección de elementos no utilizados la recupere.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica la matriz de transformación para esto Pen por el especificado Matrix en el orden especificado.
MultiplyTransform(Matrix)	Multiplica la matriz de transformación para esto Pen por el especificado Matrix.
ResetTransform()	Restablece la matriz de transformación geométrica para que esta Pen sea la identidad.
RotateTransform(Single, MatrixOrder)	Gira la transformación geométrica local por el ángulo especificado en el orden especificado.
RotateTransform(Single)	Gira la transformación geométrica local por el ángulo especificado. Este método antepone la rotación a la transformación.
ScaleTransform(Single, Single, MatrixOrder)	Escala la transformación geométrica local por los factores especificados en el orden especificado.
ScaleTransform(Single, Single)	Escala la transformación geométrica local por los factores especificados. Este método antepone la matriz de escalado a la transformación.
SetLineCap(LineCap, LineCap, DashCap)	Establece los valores que determinan el estilo de límite usado para finalizar las líneas dibujadas por este Pen.
TranslateTransform(Single, Single, MatrixOrder)	Traduce la transformación geométrica local por las dimensiones especificadas en el orden especificado.
TranslateTransform(Single, Single)	Traduce la transformación geométrica local por las dimensiones especificadas. Este método antepone la traducción a la transformación.