string-field

Returns a string value from a specified field on the current record.

Attributes

Attributes

Description

alignment

Sets the horizontal justification of the text based on a defined width.

Type: String
Default Value: left
Values: left | center | right

color

Sets the font color by the using RGB-triplet (#ffffff for white; #ff0000 for red, etc) or from list of the predefined colors below.

Type: String
Default Value: black
Predefined Values: black | blue| cyan | darkGray | gray | green | lightGray | magenta | orange | pink | red | white | yellow

dynamic

A dynamic element increases the height of the element to fit the content of that element. Computing that dynamic height is expensive, so use it with care.

excel-wrap-text

When outputting to Excel, sets the text to word wrap.

Type: Boolean
Default Value: true

fieldname

The fieldname defines the name of the column of the tablemodel or the name of the function/expression/report property from where to read the data. Any value found in the column will be converted into a String using String.valueOf (...).

font-embedded

Specifies the font to embed into the PDF file.

Type: Boolean
Default Value: false

font-encoding

Specifies the encoding to be used for the PDF.

Type: String

fontname

Sets the font name.

Type: String

fontsize

Sets the font size.

Type: Integer

fontstyle

Sets font style. This is a shortcut for defining fsbold and fsitalic.

Type: String
Values: plain | bold | italic | bolditalic

fsbold

Sets font to italics.

Type: Boolean
Default Value: false

fsitalic

Sets font to italics.

Type: Boolean
Default Value: false

fsstrikethr

Sets font to strikethrough.

Type: Boolean
Default Value: false

fsunderline

Sets font to underline.

Type: Boolean
Default Value: false

height

Determines the minimum height. Value is a whole number where each increment is equivalent to 1/72 of an inch or percentage. Height is required.

Type: Integer
Default: If no height is specified, then height will be determine by all the objects contained.

href

Sets a hyperlink for the section.

Type: String

line-height

The height of a single text line in text elements. If the line-height is set and is greater than the font size, extra padding will be added between the lines making text more readable.

Type: Integer

name

Used to reference the element later. Functions pick up elements by their name.

Type: String

nullstring

If a null value, replace with a predefined value.

reserve-literal

Determines the text printed when the text does not fit completely into an element.

Type: String
Default value: "..."

trim-text-content

Defines, whether leading and trailing whitespaces of the generated lines get removed. Important for a clean layout.

Type: Boolean
Default Value: true

vertical-alignment

Sets the vertical position of the text.

Default Value: top
Values: top | middle | bottom

visible

Sets whether the object will be printed.

Type: Boolean
Default Value: true

width

Set the horizontal width of the object. Width is required.

x

Defines the horizontal starting position an object defined by a value or percentage.

y

Defines the vertical starting position of an object defined by a value or percentage.