Pen Classe

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Pen.cs

Define um objeto usado para desenhar linhas e curvas. Essa classe não pode ser herdada.

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

Object

MarshalByRefObject

Pen

Implementações

ICloneable IDisposable

Exemplos

O exemplo de código a seguir demonstra a construção de um Pen com um Brush e os efeitos de definir a LineJoin propriedade em um Pen.

Este exemplo foi projetado para ser usado com 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.

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. Use a DashStyle propriedade para desenhar várias variedades de linhas tracejadas. A linha desenhada por um Pen pode ser preenchida em uma variedade de estilos de preenchimento, incluindo cores sólidas e texturas. O estilo de preenchimento depende do pincel ou textura que é usado como o objeto de preenchimento.

Observação

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

Construtores

Pen(Brush)	Inicializa uma nova instância da classe Pen com o Brush especificado.
Pen(Brush, Single)	Inicializa uma nova instância da classe Pen com o Brush e Width especificados.
Pen(Color)	Inicializa uma nova instância da classe Pen com a cor especificada.
Pen(Color, Single)	Inicializa uma nova instância da classe Pen com as propriedades Color e Width especificadas.

Propriedades

Alignment	Obtém ou define o alinhamento deste Pen.
Brush	Obtém ou define o Brush que determina os atributos desse Pen.
Color	Obtém ou define a cor deste Pen.
CompoundArray	Obtém ou define uma matriz de valores que especifica uma caneta composta. Uma caneta composta desenha uma linha composta que consiste em linhas paralelas e espaços.
CustomEndCap	Obtém ou define um limite personalizado a ser usado ao final das linhas desenhadas com este Pen.
CustomStartCap	Obtém ou define um limite personalizado para usar no início das linhas desenhadas com este Pen.
DashCap	Obtém ou define o estilo de extremidade na extremidade dos traços que compõem as linhas tracejadas desenhadas com este Pen.
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.
DashPattern	Obtém ou define uma matriz de traços e espaços personalizados.
DashStyle	Obtém ou define o estilo usado para as linhas tracejadas desenhadas com este Pen.
EndCap	Obtém ou define o estilo do limite usado no final das linhas desenhadas com esta Pen.
LineJoin	Obtém ou define o estilo de junção para as extremidades de duas linhas consecutivas desenhadas com essa Pen.
MiterLimit	Obtém ou define o limite da espessura da junção em um canto de malhete.
PenType	Obtém o estilo das linhas desenhadas com este Pen.
StartCap	Obtém ou define o estilo do limite usado no início das linhas desenhadas com este Pen.
Transform	Obtém ou define uma cópia da transformação geométrica para este Pen.
Width	Obtém ou define a largura dessa Pen, em unidades do objeto Graphics usado para o desenho.

Métodos

Clone()	Cria uma cópia exata deste Pen.
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. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados por este Pen.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Finalize()	Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
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. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
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. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplica a matriz de transformação para este Pen pelo Matrix especificado.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica a matriz de transformação para este Pen pelo Matrix especificado na ordem especificada.
ResetTransform()	Redefine a matriz de transformação geométrica para este Pen para a identidade.
RotateTransform(Single)	Gira a transformação geométrica local pelo ângulo especificado. Esse método precede a rotação para a transformação.
RotateTransform(Single, MatrixOrder)	Gira a transformação geométrica local pelo ângulo especificado na ordem especificada.
ScaleTransform(Single, Single)	Coloca em escala a transformação geométrica local pelos fatores especificados. Esse método precede a matriz de escala para a transformação.
ScaleTransform(Single, Single, MatrixOrder)	Ajusta a transformação geométrica local por fatores especificados na ordem especificada.
SetLineCap(LineCap, LineCap, DashCap)	Define os valores que determinam o estilo da tampa usada para terminar as linhas desenhadas por esse Pen.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TranslateTransform(Single, Single)	Converte a transformação geométrica local pelas dimensões especificadas. Esse método precede a translação para a transformação.
TranslateTransform(Single, Single, MatrixOrder)	Converte a transformação geométrica local pelas dimensões especificadas na ordem especificada.