Pen Constructeurs

  • Référence

Définition

Espace de noms:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Paquet:
System.Drawing.Common v6.0.0
Paquet:
System.Drawing.Common v7.0.0
Paquet:
System.Drawing.Common v8.0.0
Paquet:
System.Drawing.Common v9.0.0-preview.2.24128.3

Initialise une nouvelle instance de la classe Pen avec la couleur spécifiée.

Surcharges

Pen(Brush)

Initialise une nouvelle instance de la classe Pen avec le Brush spécifié.
Pen(Color)

Initialise une nouvelle instance de la classe Pen avec la couleur spécifiée.
Pen(Brush, Single)

Initialise une nouvelle instance de la classe Pen avec les Brush et Width spécifiés.
Pen(Color, Single)

Initialise une nouvelle instance de la classe Pen avec les propriétés Color et Width spécifiées.

Pen(Brush)

Source:
Pen.cs
Source:
Pen.cs
Source:
Pen.cs

Initialise une nouvelle instance de la classe Pen avec le Brush spécifié.

public:
 Pen(System::Drawing::Brush ^ brush);
public Pen (System.Drawing.Brush brush);
new System.Drawing.Pen : System.Drawing.Brush -> System.Drawing.Pen
Public Sub New (brush As Brush)

Paramètres

brush
Brush

Brush qui détermine les propriétés de remplissage de ce Pen.

Exceptions

ArgumentNullException

brush a la valeur null.

Exemples

L’exemple de code suivant illustre la construction d’un Pen avec un Brush et les effets de la définition de la LineJoin propriété sur un Pen.

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ShowLineJoin gestion de l’événement du Paint formulaire, en passant e comme 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

Remarques

La Brush propriété détermine la façon dont le dessine les Pen lignes. Les lignes sont dessinées comme s’il s’agit de rectangles remplis, avec les caractéristiques du spécifié Brush.

La Width propriété du nouveau Pen est définie sur 1 (valeur par défaut).

S’applique à

Pen(Color)

Source:
Pen.cs
Source:
Pen.cs
Source:
Pen.cs

Initialise une nouvelle instance de la classe Pen avec la couleur spécifiée.

public:
 Pen(System::Drawing::Color color);
public Pen (System.Drawing.Color color);
new System.Drawing.Pen : System.Drawing.Color -> System.Drawing.Pen
Public Sub New (color As Color)

Paramètres

color
Color

Structure Color qui indique la couleur de ce Pen.

Remarques

La Color propriété est définie sur la couleur spécifiée par le color paramètre . La Width propriété a la valeur 1 (valeur par défaut).

S’applique à

Pen(Brush, Single)

Source:
Pen.cs
Source:
Pen.cs
Source:
Pen.cs

Initialise une nouvelle instance de la classe Pen avec les Brush et Width spécifiés.

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
Public Sub New (brush As Brush, width As Single)

Paramètres

brush
Brush

Brush qui détermine les caractéristiques de ce Pen.

width
Single

Largeur du nouveau Pen.

Exceptions

ArgumentNullException

brush a la valeur null.

Exemples

L’exemple de code suivant crée un Pen et illustre les effets de la StartCap définition des propriétés et EndCap sur un Pen.

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ShowStartAndEndCaps gestion de l’événement du Paint formulaire, en passant e comme 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

Remarques

est Brush défini sur la couleur spécifiée dans le brush paramètre, la Width propriété est définie sur la valeur spécifiée dans le width paramètre et les unités sont définies sur World.

Notez que le brush paramètre spécifie également la Color propriété de ce Pen.

Si cette valeur est 0, la largeur en unités d’appareil est toujours de 1 pixel. Elle n’est pas affectée par les opérations de transformation d’échelle qui sont en vigueur pour l’objet Pen Graphics utilisé.

S’applique à

Pen(Color, Single)

Source:
Pen.cs
Source:
Pen.cs
Source:
Pen.cs

Initialise une nouvelle instance de la classe Pen avec les propriétés Color et Width spécifiées.

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
Public Sub New (color As Color, width As Single)

Paramètres

color
Color

Structure Color qui indique la couleur de ce Pen.

width
Single

Valeur indiquant la largeur de ce Pen.

Exemples

L’exemple de code suivant illustre la création d’un Pen et les effets de la définition des DashCappropriétés , DashPatternet SmoothingMode .

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ShowPensAndSmoothingMode gestion de l’événement du Paint formulaire, en passant e comme 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

Remarques

La Color propriété est définie sur la couleur spécifiée par le color paramètre . La Width propriété est définie sur la valeur spécifiée dans le width paramètre . Si cette valeur est 0, la largeur en unités d’appareil est toujours de 1 pixel. Elle n’est pas affectée par les opérations de transformation d’échelle qui sont en vigueur pour l’objet Pen Graphics utilisé.

S’applique à