Pen Konstruktorer

Definition

Namnområde:: System.Drawing

Sammansättning:: System.Drawing.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av Pen klassen med den angivna färgen.

Överlagringar

Name	Description
Pen(Brush)	Initierar en ny instans av Pen klassen med angiven Brush.
Pen(Color)	Initierar en ny instans av Pen klassen med den angivna färgen.
Pen(Brush, Single)	Initierar en ny instans av Pen klassen med angivet Brush och Width.
Pen(Color, Single)	Initierar en ny instans av Pen klassen med de angivna Color egenskaperna och Width .

Pen(Brush)

Initierar en ny instans av Pen klassen med angiven 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)

Parametrar

brush: Brush

A Brush som avgör fyllningsegenskaperna för den här Pen.

Undantag

ArgumentNullException

brush är null.

Exempel

Följande kodexempel visar hur du skapar en med en Brush och effekterna av att ange LineJoin egenskapen på en Pen.Pen

Det här exemplet är utformat för att användas med Windows Forms. Klistra in koden i ett formulär och anropa ShowLineJoin metoden när du hanterar formulärets Paint händelse och skicka e som 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

Kommentarer

Egenskapen Brush avgör hur linjerna Pen ritas. Linjer ritas som om de är fyllda rektanglar, med egenskaperna för den angivna Brush.

Egenskapen Width för den nya Pen är inställd på 1 (standardvärdet).

Gäller för

Pen(Color)

Initierar en ny instans av Pen klassen med den angivna färgen.

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)

Parametrar

color: Color

En Color struktur som anger färgen på den här Pen.

Kommentarer

Egenskapen Color är inställd på den färg som anges av parametern color . Egenskapen Width är inställd på 1 (standardvärdet).

Gäller för

Pen(Brush, Single)

Initierar en ny instans av Pen klassen med angivet Brush och 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)

Parametrar

brush: Brush

A Brush som bestämmer egenskaperna för den här Pen.

width: Single

Bredden på den nya Pen.

Undantag

ArgumentNullException

brush är null.

Exempel

Följande kodexempel skapar en Pen och visar effekterna av att ange StartCap egenskaperna och EndCap på en Pen.

Det här exemplet är utformat för att användas med Windows Forms. Klistra in koden i ett formulär och anropa ShowStartAndEndCaps metoden när du hanterar formulärets Paint händelse och skicka e som 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

Kommentarer

Brush är inställt på den färg som anges i parameternbrush, Width egenskapen är inställd på det värde som anges i parametern width och enheterna är inställda på World.

Observera att parametern brush även anger egenskapen för Color den här Pen.

Om det här värdet är 0 är bredden i enhetsenheter alltid 1 bildpunkt– den påverkas inte av skalningstransformeringsåtgärder som gäller för grafikobjektet som Pen används för.

Gäller för

Pen(Color, Single)

Initierar en ny instans av Pen klassen med de angivna Color egenskaperna och Width .

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)

Parametrar

color: Color

En Color struktur som anger färgen på den här Pen.

width: Single

Ett värde som anger bredden på den här Pen.

Exempel

I följande kodexempel visas hur du skapar en Pen och effekterna av att ange DashCapegenskaperna , DashPatternoch SmoothingMode .

Det här exemplet är utformat för att användas med Windows Forms. Klistra in koden i ett formulär och anropa ShowPensAndSmoothingMode metoden när du hanterar formulärets Paint händelse och skicka e som 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

Kommentarer

Egenskapen Color är inställd på den färg som anges av parametern color . Egenskapen Width är inställd på det värde som anges i parametern width . Om det här värdet är 0 är bredden i enhetsenheter alltid 1 bildpunkt– den påverkas inte av skalningstransformeringsåtgärder som gäller för grafikobjektet som Pen används för.

Gäller för

Feedback

Var den här sidan till hjälp?