Pen.Pen(const Brush*, REAL) constructor

Article
03/07/2012

Applies to: desktop apps only

Creates a Pen object that uses the attributes of a brush and a real number to set the width of this Pen object.

Syntax

Pen(
  [in]  const Brush *brush,
  [in]  REAL width
);

Parameters

brush [in]
Type: const Brush*

Pointer to a brush to base this pen on.
width [in]
Type: REAL

Optional. Real number that specifies the width of this pen's stroke. The default value is 1.0.

Remarks

If you pass the address of a pen to one of the draw methods of a Graphics object, the width of the pen's stroke is dependent on the unit of measure specified in the Graphics object. The default unit of measure is UnitPixel, which is an element of the Unit enumeration.

Examples

The following example creates a Brush object and then creates a Pen object based on the Brush object.

SolidBrush sBrush(Color(255,255,0,0));
Pen pen(&sBrush, 4.0f);

Requirements

Minimum supported client	Windows XP, Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	GDI+ 1.0
Header	Gdipluspen.h (include Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll