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

ADD
Show: