A value class that defines the style for pen strokes. More...

#include <Wt/WPen.h>

Inheritance diagram for Wt::WPen:

Public Types
typedef PenStyle	Style
	Typedef for enum Wt::PenStyle.

typedef PenCapStyle	CapStyle
	Typedef for enum Wt::PenCapStyle.

typedef PenJoinStyle	JoinStyle
	Typedef for enum Wt::PenJoinStyle.

Public Member Functions
	WPen ()
	Creates a StandardColor::Black cosmetic pen. More...

	WPen (PenStyle style)
	Creates a StandardColor::Black pen with a particular style. More...

	WPen (const WColor &color)
	Creates a solid pen of a particular color. More...

	WPen (StandardColor color)
	Creates a solid pen of a standard color. More...

	WPen (const WGradient &gradient)
	Creates a solid pen with a gradient color. More...

bool	operator== (const WPen &other) const
	Comparison operator. More...

bool	operator!= (const WPen &other) const
	Comparison operator. More...

void	setStyle (PenStyle style)
	Sets the pen style. More...

PenStyle	style () const
	Returns the pen style. More...

void	setCapStyle (PenCapStyle style)
	Sets the style for rendering line ends. More...

PenCapStyle	capStyle () const
	Returns the style for rendering line ends. More...

void	setJoinStyle (PenJoinStyle style)
	Sets the style for rendering line joins. More...

PenJoinStyle	joinStyle () const
	Returns the style for rendering line joins. More...

void	setWidth (const WLength &width)
	Sets the pen width. More...

const WLength &	width () const
	Returns the pen width. More...

void	setColor (const WColor &color)
	Sets the pen color. More...

const WColor &	color () const
	Returns the pen color. More...

void	setGradient (const WGradient &gradient)
	Sets the pen color as a gradient. More...

const WGradient &	gradient () const
	Returns the pen color gradient. More...

virtual std::string	jsValue () const override
	Returns a JavaScript representation of the value of this object. More...

Public Member Functions inherited from Wt::WJavaScriptExposableObject
bool	isJavaScriptBound () const
	Returns whether this object is JavaScript bound. More...

std::string	jsRef () const
	Returns a JavaScript reference to this object. More...

Related Functions
(Note that these are not member functions.)

Detailed Description

A value class that defines the style for pen strokes.

A pen defines the properties of how lines (that may surround shapes) are rendered.

A pen with width 0 is a cosmetic pen, and is always rendered as 1 pixel width, regardless of transformations. Otherwized, the pen width is modified by the transformation set on the painter.

JavaScript exposability

A WPen is JavaScript exposable. If a WPen is JavaScript bound, it can be accessed in your custom JavaScript code through its handle's jsRef(). At the moment, only the color() property is exposed, e.g. a pen with the color WColor(10,20,30,255) will be represented in JavaScript as:

{
  color: [10,20,30,255]
}

Warning: A WPen that is JavaScript exposed should be modified only through its handle. Any attempt at modifying it will cause an exception to be thrown.

See also: WPainter::setPen(), WBrush, WPaintedWidget::createJSPen()

Constructor & Destructor Documentation

Wt::WPen::WPen ( )

Creates a StandardColor::Black cosmetic pen.

Constructs a StandardColor::Black solid pen of 0 width (i.e. cosmetic single pixel width), with PenCapStyle::Square line ends and PenJoinStyle::Bevel line join style.

Wt::WPen::WPen ( PenStyle style )

Creates a StandardColor::Black pen with a particular style.

Constructs a StandardColor::Black pen of 0 width (i.e. cosmetic single pixel width), with PenCapStyle::Square line ends and PenJoinStyle::Bevel line join style.

The line style is set to style.

Wt::WPen::WPen ( const WColor & color )

Creates a solid pen of a particular color.

Constructs a solid pen of 0 width (i.e. cosmetic single pixel width), with PenCapStyle::Square line ends and PenJoinStyle::Bevel line join style.

The pen color is set to color.

Wt::WPen::WPen ( StandardColor color )

Creates a solid pen of a standard color.

Constructs a solid pen of 0 width (i.e. cosmetic single pixel width), with PenCapStyle::Square line ends and PenJoinStyle::Bevel line join style.

The pen color is set to color.

Wt::WPen::WPen ( const WGradient & gradient )

Creates a solid pen with a gradient color.

Constructs a solid pen of 0 width (i.e. cosmetic single pixel width), with PenCapStyle::Square line ends and PenJoinStyle::Bevel line join style.

The pen's color is defined by the gradient color.

Member Function Documentation

PenCapStyle Wt::WPen::capStyle ( ) const

Returns the style for rendering line ends.

See also: setCapStyle(PenCapStyle)

const WColor& Wt::WPen::color ( ) const

Returns the pen color.

See also: setColor()

const WGradient& Wt::WPen::gradient ( ) const

Returns the pen color gradient.

See also: setGradient()

PenJoinStyle Wt::WPen::joinStyle ( ) const

Returns the style for rendering line joins.

See also: setJoinStyle(PenJoinStyle)

std::string Wt::WPen::jsValue ( ) const

overridevirtual

Returns a JavaScript representation of the value of this object.

Note: The value returned will reflect the current server side value of the object. If this object is JavaScript bound, this value may not reflect the actual client side value. If you need access to the client side value, use jsRef() intead.

Implements Wt::WJavaScriptExposableObject.

bool Wt::WPen::operator!= ( const WPen & other ) const

Comparison operator.

Returns true if the pens are different.

bool Wt::WPen::operator== ( const WPen & other ) const

Comparison operator.

Returns true if the pens are exactly the same.

void Wt::WPen::setCapStyle ( PenCapStyle style )

Sets the style for rendering line ends.

The cap style configures how line ends are rendered.

Exceptions