Pen Clase

Definición

Define un objeto usado 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

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

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 al ShowLineJoin método al controlar el evento del formulario Paint , 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

PenDibuja una línea de ancho y estilo especificados.A Pen draws a line of specified width and style. Utilice la DashStyle propiedad para dibujar varias variedades de líneas discontinuas.Use the DashStyle property to draw several varieties of dashed lines. La línea dibujada por un Pen se puede rellenar en varios estilos de relleno, incluidos 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 la 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)

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)

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

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)

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

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

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

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

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

Obtiene o establece un extremo personalizado que se usa 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

Obtiene o establece un punto de conexión personalizado que se usa 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

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.Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

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

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

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

Obtiene o establece el estilo de punto de conexión que se usa 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

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

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

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

StartCap

Obtiene o establece el estilo de extremo que se usa 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

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

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

Métodos

Clone()

Crea una copia exacta de este objeto Pen.Creates an exact copy of this 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

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

Equals(Object)

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

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

GetHashCode()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
GetType()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
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)

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

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)

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)

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)

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)

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)

Establece los valores que determinan el estilo de extremo que se usa 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()

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

(Heredado de Object)
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)

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