Pen Pen Pen Pen Class

Definición

Define un objeto utilizado para dibujar líneas y curvas.Defines an object used to draw lines and curves. Esta clase no puede heredarse.This class cannot be inherited.

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
Implementaciones

Ejemplos

El ejemplo de código siguiente se muestra cómo construir un Pen con un Brush y los efectos de la configuración de la LineJoin propiedad en un Pen.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

En este ejemplo está diseñado para usarse con Windows Forms.This example is designed to be used with Windows Forms. Pegue el código en un formulario y llame a la ShowLineJoin método cuando el control del formulario Paint evento pasando e como PaintEventArgs.Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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.A Pen draws a line of specified width and style. Use el DashStyle propiedad que se va a dibujar varios tipos de líneas discontinuas.Use the DashStyle property to draw several varieties of dashed lines. La línea dibujada por un Pen pueden rellenarse en una variedad de estilos de relleno, incluyendo colores sólidos y texturas.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. El estilo de relleno depende del pincel o de textura que se usa como el objeto de relleno.The fill style depends on brush or texture that is used as the fill object.

Constructores

Pen(Brush) Pen(Brush) Pen(Brush) Pen(Brush)

Inicializa una nueva instancia de la clase Pen con el objeto Brush especificado.Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single)

Inicializa una nueva instancia de la clase Pen con los valores especificados de Brush y Width.Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color) Pen(Color) Pen(Color) Pen(Color)

Inicializa una nueva instancia de la clase Pen con el color especificado.Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single) Pen(Color, Single) Pen(Color, Single) Pen(Color, Single)

Inicializa una nueva instancia de la clase Pen con las propiedades Color y Width especificadas.Initializes a new instance of the Pen class with the specified Color and Width properties.

Propiedades

Alignment Alignment Alignment Alignment

Obtiene o establece la alineación de este Pen.Gets or sets the alignment for this Pen.

Brush Brush Brush Brush

Obtiene o establece el Brush que determina los atributos de este Pen.Gets or sets the Brush that determines attributes of this Pen.

Color Color Color Color

Obtiene o establece el color de este Pen.Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray CompoundArray

Obtiene o establece una matriz de valores que especifica un lápiz compuesto.Gets or sets an array of values that specifies a compound pen. Un lápiz compuesto dibuja una línea compuesta formada por líneas y espacios paralelos.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap CustomEndCap CustomEndCap CustomEndCap

Obtiene o establece un extremo personalizado que se utiliza al final de las líneas dibujadas con este Pen.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

Obtiene o establece un extremo personalizado que se utiliza al comienzo de las líneas dibujadas con este Pen.Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap DashCap DashCap DashCap

Obtiene o establece el estilo de extremo que se utiliza al final de los guiones que forman las líneas discontinuas dibujadas con este Pen.Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset DashOffset DashOffset DashOffset

Obtiene o establece la distancia desde el comienzo de una línea hasta el comienzo de un modelo de guiones.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern DashPattern DashPattern DashPattern

Obtiene o establece una matriz de guiones y espacios personalizados.Gets or sets an array of custom dashes and spaces.

DashStyle DashStyle DashStyle DashStyle

Obtiene o establece el estilo de las líneas discontinuas dibujadas con este Pen.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap EndCap EndCap EndCap

Obtiene o establece el estilo de extremo que se utiliza al final de las líneas dibujadas con este Pen.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin LineJoin LineJoin LineJoin

Obtiene o establece el estilo de unión de los extremos de dos líneas consecutivas dibujadas con este Pen.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit MiterLimit MiterLimit MiterLimit

Obtiene o establece el límite del grosor de la combinación en una esquina en ángulo.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType PenType PenType PenType

Obtiene el estilo de las líneas dibujadas con este Pen.Gets the style of lines drawn with this Pen.

StartCap StartCap StartCap StartCap

Obtiene o establece el estilo de extremo que se utiliza al comienzo de las líneas dibujadas con este Pen.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform Transform Transform Transform

Obtiene o establece una copia de la transformación geométrica para este objeto Pen.Gets or sets a copy of the geometric transformation for this Pen.

Width Width Width Width

Obtiene o establece el ancho de este objeto Pen, en unidades del objeto Graphics utilizado para dibujar.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Métodos

Clone() Clone() Clone() Clone()

Crea una copia exacta de este objeto Pen.Creates an exact copy of this Pen.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos utilizados por este Pen.Releases all resources used by this Pen.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() 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.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

Multiplica la matriz de transformación de este Pen por la Matrix especificada.Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

Multiplica la matriz de transformación de este Pen por la Matrix especificada y en el orden especificado.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

Restablece la matriz de transformación geométrica de este Pen en identidad.Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

Gira la transformación geométrica local el ángulo especificado.Rotates the local geometric transformation by the specified angle. Este método antepone la rotación a la transformación.This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

Gira la transformación geométrica local el ángulo especificado y en el orden especificado.Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single)

Cambia el tamaño de la transformación geométrica local en los factores especificados.Scales the local geometric transformation by the specified factors. Este método antepone la matriz de escala a la transformación.This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

Cambia el tamaño de la transformación geométrica local en los factores y en el orden especificados.Scales the local geometric transformation by the specified factors in the specified order.

SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap)

Establece los valores que determinan el estilo de extremo que se utiliza para finalizar las líneas dibujadas con este Pen.Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Convierte la transformación geométrica local en las dimensiones especificadas.Translates the local geometric transformation by the specified dimensions. Este método antepone la conversión a la transformación.This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

Convierte la transformación geométrica local en las dimensiones especificadas en el orden indicado.Translates the local geometric transformation by the specified dimensions in the specified order.

Se aplica a