Pen Clase

  • Referencia

Definición

Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing.Common.dll
Ensamblado:
System.Drawing.dll
Paquete:
System.Drawing.Common v6.0.0
Paquete:
System.Drawing.Common v7.0.0
Paquete:
System.Drawing.Common v8.0.0
Paquete:
System.Drawing.Common v9.0.0-preview.2.24128.3
Source:
Pen.cs
Source:
Pen.cs
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 Penobjeto .

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

Dibuja Pen 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, vea System.Drawing.Common solo compatible con Windows.

Constructores

Pen(Brush)

Inicializa una nueva instancia de la clase Pen con el objeto Brush especificado.
Pen(Brush, Single)

Inicializa una nueva instancia de la clase Pen con los parámetros Brush y Width especificados.
Pen(Color)

Inicializa una nueva instancia de la clase Pen con el color especificado.
Pen(Color, Single)

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

Propiedades

Alignment

Obtiene o establece la alineación de este Pen.
Brush

Obtiene o establece el Brush que determina los atributos de este Pen.
Color

Obtiene o establece el color de este Pen.
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 extremo personalizado que se usa al final de las líneas dibujadas con este Pen.
CustomStartCap

Obtiene o establece un punto de conexión personalizado que se usa al comienzo de las líneas dibujadas con este Pen.
DashCap

Obtiene o establece el estilo de punto de conexión que se usa al final de los guiones que forman las líneas discontinuas dibujadas con este Pen.
DashOffset

Obtiene o establece la distancia desde el comienzo de una línea hasta el comienzo de un modelo de guiones.
DashPattern

Obtiene o establece una matriz de guiones y espacios personalizados.
DashStyle

Obtiene o establece el estilo de las líneas discontinuas dibujadas con este Pen.
EndCap

Obtiene o establece el estilo de punto de conexión que se usa al final de las líneas dibujadas con este Pen.
LineJoin

Obtiene o establece el estilo de unión de los puntos de conexión 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 en ángulo.
PenType

Obtiene el estilo de las líneas dibujadas con este Pen.
StartCap

Obtiene o establece el estilo de extremo que se usa al comienzo de las líneas dibujadas con este Pen.
Transform

Obtiene o establece una copia de la transformación geométrica para este objeto Pen.
Width

Obtiene o establece el ancho de este objeto Pen, en unidades del objeto Graphics usado para dibujar.

Métodos

Clone()

Crea una copia exacta de este objeto Pen.
CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos utilizados por este Pen.
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Finalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
MultiplyTransform(Matrix)

Multiplica la matriz de transformación de este Pen por la Matrix especificada.
MultiplyTransform(Matrix, MatrixOrder)

Multiplica la matriz de transformación de este Pen por la Matrix especificada y en el orden especificado.
ResetTransform()

Restablece la matriz de transformación geométrica de este Pen en identidad.
RotateTransform(Single)

Gira la transformación geométrica local el ángulo especificado. Este método antepone la rotación a la transformación.
RotateTransform(Single, MatrixOrder)

Gira la transformación geométrica local el ángulo especificado y en el orden especificado.
ScaleTransform(Single, Single)

Cambia el tamaño de la transformación geométrica local en los factores especificados. Este método antepone la matriz de escala a la transformación.
ScaleTransform(Single, Single, MatrixOrder)

Cambia el tamaño de la transformación geométrica local en los factores y en el orden especificados.
SetLineCap(LineCap, LineCap, DashCap)

Establece los valores que determinan el estilo de extremo que se usa para finalizar las líneas dibujadas con este Pen.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TranslateTransform(Single, Single)

Convierte la transformación geométrica local en las dimensiones especificadas. Este método antepone la conversión a la transformación.
TranslateTransform(Single, Single, MatrixOrder)

Convierte la transformación geométrica local en las dimensiones especificadas en el orden indicado.

Se aplica a