VLINE

Top  Previous  Next

Syntax

 

vline "text" [,erase] [,extend] [,thickness]

 

Description

 

Any vertical occurrence of the text indicated, of at least the length indicated, will be replaced with a vertical line.  The text must be composed of a single character repeated any number of times. There can be multiple vline keywords in a rule set, if needed.

 

This keyword is useful if the application already produces boxes and lines with standard characters.  See also the hline keyword.

 

As with all box drawing, UnForm will consider line end-points to be at the center position of a character, which may impact how lines intersect.  Lines are drawn one dot (1/300th inch) thick.

 

If the "erase" option is used, then no line is drawn.  Instead, the vertical text values are simply removed from the output.

 

If the "extend" option is used, the lines are extended ½ characters up and down.  The thickness parameter specifies a pixel width to draw.

 

The search for text can be limited to a region on the page by adding a suffix in the format '@left,top,right,bottom'.  To use a literal "@" character in text, it is necessary to specify "\@".

 

Example:

 

vline "|" will search the report for pipe characters.  All such characters found will be replaced with vertical line draw (box) characters.

 

 

Drivers: all

 

PostScript input not supported.