Pen Constructors

Definitie

Naamruimte:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pakket:: System.Drawing.Common v11.0.0-preview.4.26230.115

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven kleur.

Overloads

Name	Description
Pen(Brush)	Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Brush.
Pen(Color)	Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven kleur.
Pen(Brush, Single)	Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Brush en Width.
Pen(Color, Single)	Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Color en Width eigenschappen.

Pen(Brush)

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Brush.

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)

Parameters

brush: Brush

Een Brush die de vuleigenschappen van deze Peneigenschap bepaalt.

Uitzonderingen

ArgumentNullException

brush is null.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een Pen met een Brush en de effecten van het instellen van de LineJoin eigenschap op een Pen.

Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Plak de code in een formulier en roep de methode aan bij het ShowLineJoin verwerken van de gebeurtenis van Paint het formulier, waarbij deze wordt doorgegeven e als 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

Opmerkingen

De Brush eigenschap bepaalt hoe de Pen lijnen worden tekent. Lijnen worden getekend alsof ze gevulde rechthoeken zijn, met de kenmerken van de opgegeven Brush.

De Width eigenschap van het nieuwe Pen is ingesteld op 1 (de standaardinstelling).

Van toepassing op

Pen(Color)

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven kleur.

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)

Parameters

color: Color

Een Color structuur die de kleur ervan Penaangeeft.

Opmerkingen

De Color eigenschap is ingesteld op de kleur die is opgegeven door de color parameter. De Width eigenschap is ingesteld op 1 (de standaardinstelling).

Van toepassing op

Pen(Brush, Single)

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Brush en 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

Public Sub New (brush As Brush, width As Single)

Parameters

brush: Brush

Een Brush die de kenmerken van dit Penbepaalt.

width: Single

De breedte van het nieuwe Pen.

Uitzonderingen

ArgumentNullException

brush is null.

Voorbeelden

In het volgende codevoorbeeld wordt een Pen en gedemonstreert u de effecten van het instellen van de StartCap en EndCap eigenschappen op een Pen.

Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Plak de code in een formulier en roep de methode aan bij het ShowStartAndEndCaps verwerken van de gebeurtenis van Paint het formulier, waarbij deze wordt doorgegeven e als 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

Opmerkingen

De Brush eigenschap wordt ingesteld op de kleur die is opgegeven in de brush parameter, de Width eigenschap wordt ingesteld op de waarde die is opgegeven in de width parameter en de eenheden worden ingesteld op World.

Houd er rekening mee dat met de brush parameter ook de Color eigenschap van deze Penparameter wordt opgegeven.

Als deze waarde 0 is, is de breedte in apparaateenheden altijd 1 pixel. Dit wordt niet beïnvloed door bewerkingen voor schaaltransformatie die van kracht zijn voor het grafische object waarvoor het Pen wordt gebruikt.

Van toepassing op

Pen(Color, Single)

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Bron:: Pen.cs

Initialiseert een nieuw exemplaar van de Pen klasse met de opgegeven Color en Width eigenschappen.

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)

Parameters

color: Color

Een Color structuur die de kleur ervan Penaangeeft.

width: Single

Een waarde die de breedte van deze Penwaarde aangeeft.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een Pen en de effecten van het instellen van de DashCap, DashPatternen SmoothingMode eigenschappen maakt.

Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Plak de code in een formulier en roep de ShowPensAndSmoothingMode methode aan bij het verwerken van de gebeurtenis van Paint het formulier, waarbij e wordt doorgegeven als 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

Opmerkingen

De Color eigenschap is ingesteld op de kleur die is opgegeven door de color parameter. De Width eigenschap is ingesteld op de waarde die is opgegeven in de width parameter. Als deze waarde 0 is, is de breedte in apparaateenheden altijd 1 pixel. Dit wordt niet beïnvloed door bewerkingen voor schaaltransformatie die van kracht zijn voor het grafische object waarvoor het Pen wordt gebruikt.

Van toepassing op

Feedback

Is deze pagina nuttig?