wx:pen%

Superclass: wx:object%

A pen is a drawing tool for drawing lines and outlines; i.e., for drawing lines and painting the outline of rectangles, ellipses, etc. It has a colour, a width and a style. On a monochrome display, the all non-white pens are drawn as black.

The possible pen styles are:

• wx:const-solid
• wx:const-dot
• wx:const-long-dash
• wx:const-short-dash
• wx:const-dot-dash
• wx:const-stipple -- uses stipple installed with set-stipple; background of a 1-bit bitmap may translate as transparent on some platforms and drawing destinations.
• wx:const-opaque-stipple -- same as wx:const-stipple, but the background is never transparent

Instead of using one of these styles, an arbitrary stipple bitmap can be specified.

To avoid creating multiple pens with the same characteristics, use the global wx:pen-list% object wx:the-pen-list.

A pen of size 0 uses the minimum visible size for the distination. In [unscaled] screens and bitmaps, this behaves the same as a pen of size 1. In a wx:post-script-dc%, a pen of size 0 typically draws a line thinner than 1.

• (make-object wx:pen%) -> wx:pen% object

  
  

• (make-object wx:pen% colour width style) -> wx:pen% object
      colour : wx:colour% object
      width : small integer
      style : small integer

  Creates a pen using a colour object. See wx:pen% for the possible values of the style argument.

  
  

• (make-object wx:pen% colour-name width style) -> wx:pen% object
      colour-name : string
      width : small integer
      style : small integer

  Creates a pen using a colour name; a colour is found for the name through the global wx:colour-database% object wx:the-colour-database. See wx:pen% for the possible values of the style argument.

  
  

Methods:

• get-cap
• get-colour
• get-join
• get-stipple
• get-style
• get-width
• set-cap
• set-colour
• set-join
• set-stipple
• set-style
• set-width