Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Pen class

Applies to: desktop apps only

A Pen object is a Windows GDI+ object used to draw lines and curves.

Members

The Pen class inherits from GdiplusBase. Pen also has these types of members:

Constructors

The Pen class has these constructors.

ConstructorDescription
Pen::Pen(Brush*,REAL)

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

Pen::Pen(Color&,REAL)

Creates a Pen object that uses a specified color and width.

 

Methods

The Pen class has these methods.

MethodDescription
Pen::Clone

The Pen::Clone method copies a Pen object.

Pen::GetAlignment

The Pen::GetAlignment method gets the alignment currently set for this Pen object.

Pen::GetBrush

The Pen::GetBrush method gets the Brush object that is currently set for this Pen object.

Pen::GetColor

The Pen::GetColor method gets the color currently set for this Pen object.

Pen::GetCompoundArray

The Pen::GetCompoundArray method gets the compound array currently set for this Pen object.

Pen::GetCompoundArrayCount

The Pen::GetCompoundArrayCount method gets the number of elements in a compound array.

Pen::GetCustomEndCap

The Pen::GetCustomEndCap method gets the custom end cap currently set for this Pen object.

Pen::GetCustomStartCap

The Pen::GetCustomStartCap method gets the custom start cap currently set for this Pen object.

Pen::GetDashCap

The Pen::GetDashCap method gets the dash cap style currently set for this Pen object.

Pen::GetDashOffset

The Pen::GetDashOffset method gets the distance from the start of the line to the start of the first space in a dashed line.

Pen::GetDashPattern

The Pen::GetDashPattern method gets an array of custom dashes and spaces currently set for this Pen object.

Pen::GetDashPatternCount

The Pen::GetDashPatternCount method gets the number of elements in a dash pattern array.

Pen::GetDashStyle

The Pen::GetDashStyle method gets the dash style currently set for this Pen object.

Pen::GetEndCap

The Pen::GetEndCap method gets the end cap currently set for this Pen object.

Pen::GetLastStatus

The Pen::GetLastStatus method returns a value that indicates the nature of this Pen object's most recent method failure.

Pen::GetLineJoin

The Pen::GetLineJoin method gets the line join style currently set for this Pen object.

Pen::GetMiterLimit

The Pen::GetMiterLimit method gets the miter length currently set for this Pen object.

Pen::GetPenType

The Pen::GetPenType method gets the type currently set for this Pen object.

Pen::GetStartCap

The Pen::GetStartCap method gets the start cap currently set for this Pen object.

Pen::GetTransform

The Pen::GetTransform method gets the world transformation matrix currently set for this Pen object.

Pen::GetWidth

The Pen::GetWidth method gets the width currently set for this Pen object.

Pen::MultiplyTransform

The Pen::MultiplyTransform method updates the world transformation matrix of this Pen object with the product of itself and another matrix.

Pen::ResetTransform

The Pen::ResetTransform method sets the world transformation matrix of this Pen object to the identity matrix.

Pen::RotateTransform

The Pen::RotateTransform method updates the world transformation matrix of this Pen object with the product of itself and a rotation matrix.

Pen::ScaleTransform

The Pen::ScaleTransform method sets the Pen object's world transformation matrix equal to the product of itself and a scaling matrix.

Pen::SetAlignment

The Pen::SetAlignment method sets the alignment for this Pen object relative to the line.

Pen::SetBrush

The Pen::SetBrush method sets the Brush object that a pen uses to fill a line.

Pen::SetColor

The Pen::SetColor method sets the color for this Pen object.

Pen::SetCompoundArray

The Pen::SetCompoundArray method sets the compound array for this Pen object.

Pen::SetCustomEndCap

The Pen::SetCustomEndCap method sets the custom end cap for this Pen object.

Pen::SetCustomStartCap

The Pen::SetCustomStartCap method sets the custom start cap for this Pen object.

Pen::SetDashCap

The Pen::SetDashCap method sets the dash cap style for this Pen object.

Pen::SetDashOffset

The Pen::SetDashOffset method sets the distance from the start of the line to the start of the first dash in a dashed line.

Pen::SetDashPattern

The Pen::SetDashPattern method sets an array of custom dashes and spaces for this Pen object.

Pen::SetDashStyle

The Pen::SetDashStyle method sets the dash style for this Pen object.

Pen::SetEndCap

The Pen::SetEndCap method sets the end cap for this Pen object.

Pen::SetLineCap

The Pen::SetLineCap method sets the cap styles for the start, end, and dashes in a line drawn with this pen.

Pen::SetLineJoin

The Pen::SetLineJoin method sets the line join for this Pen object.

Pen::SetMiterLimit

The Pen::SetMiterLimit method sets the miter limit of this Pen object.

Pen::SetStartCap

The Pen::SetStartCap method sets the start cap for this Pen object.

Pen::SetTransform

The Pen::SetTransform method sets the world transformation of this Pen object.

Pen::SetWidth

The Pen::SetWidth method sets the width for this Pen object.

 

Remarks

A Pen object has attributes that can be set to adjust the width, color, and style used to draw lines and curves.

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

Show:
© 2015 Microsoft