Wx::Pen

A pen is a drawing tool for drawing outlines. It is used for drawing lines and painting the outline of rectangles, ellipses, etc. It has a colour, a width and a style.

Derived from

GDIObject

Object

Predefined objects

The following standard pens are available to all applications:

Wx::NULL_PEN
Wx::RED_PEN
Wx::CYAN_PEN
Wx::GREEN_PEN
Wx::BLACK_PEN
Wx::WHITE_PEN
Wx::TRANSPARENT_PEN
Wx::BLACK_DASHED_PEN
Wx::GREY_PEN
Wx::MEDIUM_GREY_PEN
Wx::LIGHT_GREY_PEN

Remarks

On a monochrome display, wxRUby shows all non-white pens as black.

Do not initialize Pens before the application commences, since other required structures may not have been set up yet. Instead, define methods which return Pens, and initialize them on first call.

See also

PenList, DC, DC#set_pen, Brush

Pen.new

Pen.new(Colour colour,  
           Integer width = 1, 
           Integer style = SOLID)

Constructs a pen from a colour object, pen width and style.

Pen.new(String colourName,  
           Integer width, 
           Integer style)

Constructs a pen from a colour name, pen width and style.

Pen.new(Bitmap stipple, 
           Integer width)

Constructs a stippled pen from a stipple bitmap and a width.

Parameters

• colour A colour object.
• colourName A colour name.
• width Pen width. Under Windows, the pen width cannot be greater than 1 if the style is DOT, LONG_DASH, SHORT_DASH, DOT_DASH, or USER_DASH.
• stipple A stipple bitmap.
• style The style may be one of the following:

Remarks

Different versions of Windows and different versions of other platforms support very different subsets of the styles above – there is no similarity even between Windows95 and Windows98 – so handle with care, and test across platforms.

If the named colour form is used, an appropriate Wx::Colour structure is found in the colour database.

See also

Pen#set_style, Pen#set_colour, Pen#set_width, Pen#set_stipple

Pen#get_cap

Integer get_cap()

Returns the pen cap style, which may be one of Wx::CAP_ROUND, Wx::CAP_PROJECTING and Wx::CAP_BUTT. The default is Wx::CAP_ROUND.

Pen#get_colour

Colour get_colour()

Returns the pen’s colour

Pen#get_dashes

wxDashes get_dashes()

Gets an array of dashes (defined as char in X, DWORD under Windows). dashes is a pointer to the internal array. Do not deallocate or store this pointer. The function returns the number of dashes associated with this pen.

Not currently supported in wxRuby.

Pen#get_join

Integer get_join()

Returns the pen join style, which may be one of Wx::JOIN_BEVEL, Wx::JOIN_ROUND and Wx::JOIN_MITER. The default is Wx::JOIN_ROUND.

Pen#get_stipple

Bitmap get_stipple()

Gets the stipple bitmap.

Pen#get_style

Integer get_style()

Returns the pen style, for example Wx::SOLID.

Pen#get_width

Integer get_width()

Returns the pen width.

Pen#is_ok

Boolean is_ok()

Returns true if the pen is initialised.

Pen#set_cap

set_cap(Integer capStyle)

Sets the pen cap style, which may be one of Wx::CAP_ROUND, Wx::CAP_PROJECTING and Wx::CAP_BUTT. The default is Wx::CAP_ROUND.

Pen#set_colour

set_colour(Colour colour)

set_colour(String colour_name)

set_colour(Integer red, Integer blue, Integer green)

Specifies the colour of the pen by using a Colour, a colour name (see Colour for more details), or a set of red, green and blue values.

Pen#set_dashes

set_dashes(wxDashes)

Sets dashes. Not currently supported in wxRuby.

Pen#set_join

set_join(Integer join_style)

Returns the pen join style, which may be one of Wx::JOIN_BEVEL, Wx::JOIN_ROUND and Wx::JOIN_MITER. The default is Wx::JOIN_ROUND.

Pen#set_stipple

set_stipple(Bitmap stipple)

Sets the bitmap for stippling.

Pen#set_style

set_style(Integer style)

Sets the pen style; see Pen.new for valid styles.

Pen#set_width

set_width(Integer width)

Sets the pen width, in pixels.

[This page automatically generated from the Textile source at Fri Oct 31 16:06:47 +0000 2008]