Pen Classe

Definição

Espaço de Nomes:
System.Drawing
Assemblagem:
System.Drawing.dll

Define um objeto usado para desenhar linhas e curvas. Esta 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 seguinte demonstra a construção de um Pen com a Brush e os efeitos de definir a LineJoin propriedade em um Pen.

Este exemplo foi concebido para ser usado com Windows Forms. Cole o código num formulário e chame o ShowLineJoin método ao tratar 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

Observações

A Pen traça uma linha de largura e estilo especificados. Use a DashStyle propriedade para desenhar vários tipos de linhas tracejadas. A linha desenhada por a Pen pode ser preenchida em vários estilos de preenchimento, incluindo cores sólidas e texturas. O estilo de preenchimento depende do pincel ou da textura usada como objeto de preenchimento.

Note

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

Construtores

Name Description
Pen(Brush, Single)

Inicializa uma nova instância da Pen classe com os especificados Brush e Width.
Pen(Brush)

Inicializa uma nova instância da Pen classe com o especificado Brush.
Pen(Color, Single)

Inicializa uma nova instância da Pen classe com as propriedades e Width especificadasColor.
Pen(Color)

Inicializa uma nova instância da Pen classe com a cor especificada.

Propriedades

Name Description
Alignment

Obtém ou define o alinhamento para este Pen.
Brush

Obtém ou define o Brush que determina os atributos deste Pen.
Color

Obtém ou define a cor desta Pen.
CompoundArray

Obtém ou define um array de valores que especifica uma caneta composta. Uma caneta composta desenha uma linha composta composta composta por linhas e espaços paralelos.
CustomEndCap

Obtém ou define uma tampa personalizada para usar no final das linhas desenhadas com este Pen.
CustomStartCap

Obtém ou define uma tampa personalizada para usar no início das linhas desenhadas com este Pen.
DashCap

Obtém ou define o estilo de tampa usado no final dos traços que formam linhas tracejadas desenhadas com este Pen.
DashOffset

Obtém ou define a distância desde o início de uma linha até ao início de um padrão de traços.
DashPattern

Recebe ou define um conjunto de traços e espaços personalizados.
DashStyle

Obtém ou define o estilo usado para linhas tracejadas desenhadas com este Pen.
EndCap

Obtém ou define o estilo de tampa usado no final das linhas desenhadas com este Pen.
LineJoin

Obtém ou define o estilo de junção para os extremos de duas linhas consecutivas desenhadas com este Pen.
MiterLimit

Obtém ou define o limite da espessura da junção num canto em esquadra.
PenType

Obtém o estilo de linhas traçadas com isto Pen.
StartCap

Obtém ou define o estilo de tampa usado no início das linhas desenhadas com este Pen.
Transform

Obtém ou define uma cópia da transformação geométrica para esta Pen.
Width

Obtém ou define a largura deste Pen, em unidades do Graphics objeto usado para o desenho.

Métodos

Name Description
Clone()

Cria uma cópia exata deste Pen.
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta todos os recursos utilizados por este Pen.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Permite que um objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
MultiplyTransform(Matrix, MatrixOrder)

Multiplica a matriz de transformação para isto Pen pelo especificado Matrix na ordem especificada.
MultiplyTransform(Matrix)

Multiplica a matriz de transformação para isto Pen pelo especificado Matrix.
ResetTransform()

Reinicia a matriz de transformação geométrica para isto Pen para identidade.
RotateTransform(Single, MatrixOrder)

Roda a transformação geométrica local pelo ângulo especificado na ordem especificada.
RotateTransform(Single)

Roda a transformação geométrica local pelo ângulo especificado. Este método antepõe a rotação à transformação.
ScaleTransform(Single, Single, MatrixOrder)

Escala a transformação geométrica local pelos fatores especificados na ordem especificada.
ScaleTransform(Single, Single)

Escala a transformação geométrica local pelos fatores especificados. Este método antepõe a matriz de escala à transformação.
SetLineCap(LineCap, LineCap, DashCap)

Define os valores que determinam o estilo de maicurão usado para terminar as linhas desenhadas por este Pen.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TranslateTransform(Single, Single, MatrixOrder)

Traduz a transformação geométrica local pelas dimensões especificadas na ordem especificada.
TranslateTransform(Single, Single)

Traduz a transformação geométrica local pelas dimensões especificadas. Este método antepõe a translação à transformação.

Aplica-se a