On line guide/help

You are on page 17 of the online help. Navigate sequentially through the guide pages or search for a topic of interest to you.

Index Prev. Next

Box

Draw a text

The box element (or its alias text) prints text in an area defined by a pair of coordinates. The area can optionally be bordered and filled with a single color or a two-color gradient.


Parameters

Elements / attributes of the <box> / <text> element:

Coordinate parameters (required) that define the print area of ​​the text
<x1> Starting X coordinate (upper/left corner)
<y1> Starting Y coordinate (upper/left corner)
<x2> Ending X coordinate (bottom/right corner)
<y2> Ending Y coordinate (bottom/right corner)

The above parameters can alternatively be indicated in this way (one of the two methods is mandatory):
<x> Initial X coordinate (top/left corner)
<y> Initial Y coordinate (top/left corner)
<width> Width of the drawing area, calculated from the initial X coordinate
<height> Height of the drawing area, calculated from the initial Y coordinate

Parameters that define the the text:
<text> Text to print (empty string if not defined). If a placeholder is set in this format {var_name} the placehoder will be dinamically replaced by data (using the current data source or a variable)
<align> Horizontal text align, possible values:
L - left, C - center, R - right, J - justify
<vertalign> Vertical text align, possible values:
T - top , M - middle, B - bottom

Other parameters:
<border> Show or hide border. Possibile values:
0 Disable (hide) border
1 Enabled (show) border
1111 Enabled (shows) the border for each side of the frame area (left, top, right, bottom). You can show/hide each side of the border individually.
<linestyle> Sets the line style for the border (if not set, the default line style will be used)
<fillstyle> (or <fills>) Sets the fill style for the text area (if not set, the default fill style will be used)
<rotateangle> (or <rotate>) Defaults to 0 if not set (no rotation). Specify a numeric interger value, from 0 to 360 (degrees). Performs a rotation of the entire box around the angle x1,y1.
<fontstyle> (or <font>) Sets the font style for the text (if not set, the default font style will be used)

If text exceeds the first line, it is automatically wrapped until it fills the entire print area. Any text exceeding the print area is truncated.
Related topics / download links / see also..
21 - Font