Pen Pen Pen Constructors

Definição

Sobrecargas

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(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(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, 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.

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.

public:
 Pen(System::Drawing::Brush ^ brush);
public Pen (System.Drawing.Brush brush);
new System.Drawing.Pen : System.Drawing.Brush -> System.Drawing.Pen

Parâmetros

brush
Brush Brush Brush

Um Brush que determina as propriedades de preenchimento desta Pen.A Brush that determines the fill properties of this Pen.

Exceçõ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

A Brush propriedade determina como o Pen desenha linhas.The Brush property determines how the Pen draws lines. As linhas são desenhadas como se fossem retângulos preenchidos, com as características Brushdo especificado.Lines are drawn as if they are filled rectangles, with the characteristics of the specified Brush.

A Width Propriedade do novo Pen é definida como 1 (o padrão).The Width property of the new Pen is set to 1 (the default).

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.

public:
 Pen(System::Drawing::Color color);
public Pen (System.Drawing.Color color);
new System.Drawing.Pen : System.Drawing.Color -> System.Drawing.Pen

Parâmetros

color
Color Color Color

Uma estrutura Color que indica a cor desse Pen.A Color structure that indicates the color of this Pen.

Comentários

A Color propriedade é definida com a cor especificada color pelo parâmetro.The Color property is set to the color specified by the color parameter. A Width propriedade é definida como 1 (o padrão).The Width property is set to 1 (the default).

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.

public:
 Pen(System::Drawing::Brush ^ brush, float width);
public Pen (System.Drawing.Brush brush, float width);
new System.Drawing.Pen : System.Drawing.Brush * single -> System.Drawing.Pen

Parâmetros

brush
Brush Brush Brush

Um Brush que determina as características desse Pen.A Brush that determines the characteristics of this Pen.

width
Single Single Single

A largura do novo Pen.The width of the new Pen.

Exceções

Exemplos

O exemplo de código a seguir Pen cria um e demonstra os efeitos da StartCap definição EndCap das propriedades e Penem um.The following code example creates a Pen and demonstrates the effects of setting the StartCap and EndCap properties 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 ShowStartAndEndCaps método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.Paste the code into a form and call the ShowStartAndEndCaps method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void Button3_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Graphics^ buttonGraphics = Button3->CreateGraphics();
      Pen^ myPen = gcnew Pen( Color::ForestGreen,4.0F );
      myPen->DashStyle = System::Drawing::Drawing2D::DashStyle::DashDotDot;
      Rectangle theRectangle = Button3->ClientRectangle;
      theRectangle.Inflate(  -2, -2 );
      buttonGraphics->DrawRectangle( myPen, theRectangle );
      delete buttonGraphics;
      delete myPen;
   }
private void Button3_Click(System.Object sender, System.EventArgs e)
{

    Graphics buttonGraphics = Button3.CreateGraphics();
    Pen myPen = new Pen(Color.ForestGreen, 4.0F);
    myPen.DashStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

    Rectangle theRectangle = Button3.ClientRectangle;
    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
}
Private Sub Button3_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button3.Click

    Dim buttonGraphics As Graphics = Button3.CreateGraphics()
    Dim myPen As Pen = New Pen(Color.ForestGreen, 4.0F)
    myPen.DashStyle = Drawing2D.DashStyle.DashDotDot

    Dim theRectangle As Rectangle = Button3.ClientRectangle
    theRectangle.Inflate(-2, -2)
    buttonGraphics.DrawRectangle(myPen, theRectangle)
    buttonGraphics.Dispose()
    myPen.Dispose()
End Sub

Comentários

O Brush é definido como a cor especificada brush no parâmetro, a Width propriedade width é definida como o valor especificado no parâmetro e as unidades são definidas como World.The Brush is set to the color specified in the brush parameter, the Width property is set to the value specified in the width parameter, and the units are set to World.

Observe que o brush parâmetro também especifica a Color Propriedade desse Pen.Note that the brush parameter also specifies the Color property of this Pen.

Um width de 0 resultará Pen no desenho como se a largura fosse 1.A width of 0 will result in the Pen drawing as if the width were 1.

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.

public:
 Pen(System::Drawing::Color color, float width);
public Pen (System.Drawing.Color color, float width);
new System.Drawing.Pen : System.Drawing.Color * single -> System.Drawing.Pen

Parâmetros

color
Color Color Color

Uma estrutura Color que indica a cor desse Pen.A Color structure that indicates the color of this Pen.

width
Single Single Single

Um valor que indica a largura deste Pen.A value indicating the width of this Pen.

Exemplos

O exemplo de código a seguir demonstra Pen DashCapcomo criar um e os efeitos da DashPatterndefinição das SmoothingMode Propriedades, e.The following code example demonstrates creating a Pen and the effects of setting the DashCap, DashPattern, and SmoothingMode properties.

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 ShowPensAndSmoothingMode método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.Paste the code into a form and call the ShowPensAndSmoothingMode method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void ShowPensAndSmoothingMode( PaintEventArgs^ e )
   {
      // Set the SmoothingMode property to smooth the line.
      e->Graphics->SmoothingMode = System::Drawing::Drawing2D::SmoothingMode::AntiAlias;

      // Create a new Pen object.
      Pen^ greenPen = gcnew Pen( Color::Green );

      // Set the width to 6.
      greenPen->Width = 6.0F;

      // Set the DashCap to round.
      greenPen->DashCap = System::Drawing::Drawing2D::DashCap::Round;

      // Create a custom dash pattern.
      array<Single>^temp0 = {4.0F,2.0F,1.0F,3.0F};
      greenPen->DashPattern = temp0;

      // Draw a line.
      e->Graphics->DrawLine( greenPen, 20.0F, 20.0F, 100.0F, 240.0F );

      // Change the SmoothingMode to none.
      e->Graphics->SmoothingMode = System::Drawing::Drawing2D::SmoothingMode::None;

      // Draw another line.
      e->Graphics->DrawLine( greenPen, 100.0F, 240.0F, 160.0F, 20.0F );

      // Dispose of the custom pen.
      delete greenPen;
   }
private void ShowPensAndSmoothingMode(PaintEventArgs e)
{

    // Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

    // Create a new Pen object.
    Pen greenPen = new Pen(Color.Green);

    // Set the width to 6.
    greenPen.Width = 6.0F;

    // Set the DashCap to round.
    greenPen.DashCap = System.Drawing.Drawing2D.DashCap.Round;

    // Create a custom dash pattern.
    greenPen.DashPattern = new float[]{4.0F, 2.0F, 1.0F, 3.0F};

    // Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F);

    // Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.None;

    // Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F);

    // Dispose of the custom pen.
    greenPen.Dispose();
}
Private Sub ShowPensAndSmoothingMode(ByVal e As PaintEventArgs)

    ' Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = Drawing2D.SmoothingMode.AntiAlias

    ' Create a new Pen object.
    Dim greenPen As New Pen(Color.Green)

    ' Set the width to 6.
    greenPen.Width = 6.0F

    ' Set the DashCap to round.
    greenPen.DashCap = Drawing2D.DashCap.Round

    ' Create a custom dash pattern.
    greenPen.DashPattern = New Single() {4.0F, 2.0F, 1.0F, 3.0F}

    ' Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F)

    ' Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = Drawing2D.SmoothingMode.None

    ' Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F)

    ' Dispose of the custom pen.
    greenPen.Dispose()
End Sub

Comentários

A Color propriedade é definida com a cor especificada color pelo parâmetro.The Color property is set to the color specified by the color parameter. A Width propriedade é definida como o valor especificado width no parâmetro.The Width property is set to the value specified in the width parameter. Um width de 0 resultará Pen no desenho como se a largura fosse 1.A width of 0 will result in the Pen drawing as if the width were 1.

Aplica-se a