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. NextBox
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)
Optional parameters.
<printif>: A simple expression prints this graphic element only if it evaluates to true. If it is not defined, the element is always printed.
The expression must be written using placeholders or constants and one of these comparison operators:
= (identical)
> (greater than)
< (less than)
>= (greater than or equal to)
<= (less than or equal to)
!= (not equal to)
Examples of expressions using placeholders/constants:
{data_set.doc_type}=1
{data_set.level}>={MIN_LEVEL}