Pen Pen Pen Pen Class

Definição

Define um objeto usado para desenhar linhas e curvas.Defines an object used to draw lines and curves. Essa classe não pode ser herdada.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
Herança
Implementações

Exemplos

O exemplo de código a seguir demonstra como Pen construir um Brush com um e os efeitos de LineJoin definir a propriedade Penem um.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Este exemplo foi projetado para ser usado com Windows Forms.This example is designed to be used with Windows Forms. Cole o código em um formulário e chame o ShowLineJoin método ao manipular o evento do Paint formulário, passando 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

Comentários

Um Pen desenha uma linha de largura e estilo especificados.A Pen draws a line of specified width and style. Use a DashStyle propriedade para desenhar várias variedades de linhas tracejadas.Use the DashStyle property to draw several varieties of dashed lines. A linha desenhada Pen por um pode ser preenchida em uma variedade de estilos de preenchimento, incluindo cores sólidas e texturas.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. O estilo de preenchimento depende do pincel ou da textura que é usada como o objeto Fill.The fill style depends on brush or texture that is used as the fill object.

Construtores

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

Inicializa uma nova instância da classe Pen com o 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 uma nova instância da classe Pen com o Brush e Width especificados.Initializes a new instance of the Pen class with the specified Brush and Width.

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

Inicializa uma nova instância da classe Pen com a cor especificada.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 uma nova instância da classe Pen com as propriedades Color e Width especificadas.Initializes a new instance of the Pen class with the specified Color and Width properties.

Propriedades

Alignment Alignment Alignment Alignment

Obtém ou define o alinhamento deste Pen.Gets or sets the alignment for this Pen.

Brush Brush Brush Brush

Obtém ou define o Brush que determina os atributos desse Pen.Gets or sets the Brush that determines attributes of this Pen.

Color Color Color Color

Obtém ou define a cor desse Pen.Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray CompoundArray

Obtém ou define uma matriz de valores que especifica uma caneta composta.Gets or sets an array of values that specifies a compound pen. Uma caneta composta desenha uma linha composta que consiste em linhas paralelas e espaços.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap CustomEndCap CustomEndCap CustomEndCap

Obtém ou define um limite personalizado a ser usado ao final das linhas desenhadas com este Pen.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

Obtém ou define um limite personalizado para usar no início das linhas desenhadas com este Pen.Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap DashCap DashCap DashCap

Obtém ou define o estilo de extremidade na extremidade dos traços que compõem as linhas tracejadas desenhadas com 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

Obtém ou define a distância do início de uma linha até o início de um padrão de traço.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern DashPattern DashPattern DashPattern

Obtém ou define uma matriz de traços e espaços personalizados.Gets or sets an array of custom dashes and spaces.

DashStyle DashStyle DashStyle DashStyle

Obtém ou define o estilo usado para as linhas tracejadas desenhadas com este Pen.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap EndCap EndCap EndCap

Obtém ou define o estilo do limite usado no final das linhas desenhadas com esta Pen.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin LineJoin LineJoin LineJoin

Obtém ou define o estilo de junção para as extremidades de duas linhas consecutivas desenhadas com essa Pen.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit MiterLimit MiterLimit MiterLimit

Obtém ou define o limite da espessura da junção em um canto de malhete.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType PenType PenType PenType

Obtém o estilo das linhas desenhadas com este Pen.Gets the style of lines drawn with this Pen.

StartCap StartCap StartCap StartCap

Obtém ou define o estilo do limite usado no início das linhas desenhadas com este Pen.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform Transform Transform Transform

Obtém ou define uma cópia da transformação geométrica para este Pen.Gets or sets a copy of the geometric transformation for this Pen.

Width Width Width Width

Obtém ou define a largura dessa Pen, em unidades do objeto Graphics usado para o desenho.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Métodos

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

Cria uma cópia exata deste Pen.Creates an exact copy of this Pen.

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

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um 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 os recursos usados por este Pen.Releases all resources used by this Pen.

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

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

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

Serve como a função de hash padrão.Serves as the default hash function.

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

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Obtém o Type da instância atual.Gets the Type of the current instance.

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

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

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

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

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

Multiplica a matriz de transformação para este Pen pelo Matrix especificado.Multiplies the transformation matrix for this Pen by the specified Matrix.

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

Multiplica a matriz de transformação para este Pen pelo Matrix especificado na ordem especificada.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

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

Redefine a matriz de transformação geométrica para este Pen para a identidade.Resets the geometric transformation matrix for this Pen to identity.

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

Gira a transformação geométrica local pelo ângulo especificado.Rotates the local geometric transformation by the specified angle. Esse método precede a rotação para a transformação.This method prepends the rotation to the transformation.

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

Gira a transformação geométrica local pelo ângulo especificado na ordem especificada.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)

Coloca em escala a transformação geométrica local pelos fatores especificados.Scales the local geometric transformation by the specified factors. Esse método precede a matriz de escala para a transformação.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)

Ajusta a transformação geométrica local por fatores especificados na ordem especificada.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)

Define os valores que determinam o estilo da tampa usada para terminar as linhas desenhadas por esse Pen.Sets the values that determine the style of cap used to end lines drawn by this Pen.

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

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

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

Converte a transformação geométrica local pelas dimensões especificadas.Translates the local geometric transformation by the specified dimensions. Esse método precede a translação para a transformação.This method prepends the translation to the transformation.

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

Converte a transformação geométrica local pelas dimensões especificadas na ordem especificada.Translates the local geometric transformation by the specified dimensions in the specified order.

Aplica-se a