Pen Constructor (Brush^)

 

Initializes a new instance of the Pen class with the specified Brush.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
Pen(
	Brush^ brush
)

Parameters

brush
Type: System.Drawing::Brush^

A Brush that determines the fill properties of this Pen.

Exception Condition
ArgumentNullException

brush is null.

The Brush property determines how the Pen draws lines. Lines are drawn as if they are filled rectangles, with the characteristics of the specified Brush.

The Width property of the new Pen is set to 1 (the default).

The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

This example is designed to be used with Windows Forms. 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;
   }

.NET Framework
Available since 1.1
Return to top
Show: