Image Rendering Reference

Navigation:

IndexGeneral InformationElementsUtilsExamples

The <field> Element


Description:

The field element defines a rectangular container in which an image, text or a barcode can be placed. The position of the field can either be set by specifiying the x and y coordinates of the top left corner or by just setting the x coordinate. In the second case, the field is positioned exactly after the last field, which specified the y-coordinate (or 0, in case no field has a y-coordinate specified).

Multiple Occurrences allowed: true


Attributes

Name Description Inheritated Possible Values Default Value Examples
rotation A positive or negative rotation angle to rotate the corresponding field content false An integer value >= 0 and smaller than the specified image dimension 0 rotation1
class A identifier of a CSS class. This identifier can be referenced via a CSS file. The same class identifier is meant to be used in multiple tags false String No default value css1
id A identifier of the tag. This identifier can be referenced via a CSS file. This identifier has to be unique false String No default value css1
x The position of the element on the x-axis in pixels false An integer value >= 0 and smaller than the specified image dimension No default value -
y The position of the element on the y-axis in pixels false An integer value >= 0 and smaller than the specified image dimension No default value -
width The width of the element specified in pixels true A size value in pixel No default value -
height The height of the element specified in pixels true A size value in pixel No default value -
max-height Defines the maximum height of a field. This attribute is used in combination with a relative y-positioning. The height of the rendered field will be smaller or equal the specified maximum height value, depending on its content false An non-negative integer value (>0) No default value relative1, nestedFields1
background-color The background color of the element true black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 transparent -
border Specifies the thickness of the border around the element. A value of 0 means no border false An non-negative integer value (>0) 0 drawing1
border-color Specifies the color of the used border false black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 black -
border-style Sets the line style of the border false dotted | dashed | solid solid -
align Specifies the horizontal alignment of the element/text true left | right | center | justify left -
valign Specifies the vertical alignment of the element/text true top | center | bottom top -
rounded-corners Defines which of the corners should be rounded. Multiple corners can be specified using a colon (,) as separator. false top_left | top_right | bottom_left | bottom_right No default value drawing3
corner-radius The radius of the rounded corners of the rectangle/field. Zero radius means no rounded corners. In case the corner radius is to large, it gets adjusted automatically. The maximum radius is (Min(width,height) - 1) / 2 false A size value in pixel 0 drawing3
wrap Changes the line wrap of a text field. Normal: line wraps at spaces and dashes. None: no wrapped lines. true normal | none normal -


Child Elements

field | table | barcode | img | label | text | rect | line | triangle | ellipse | polygon

Examples