9.4 Field Definition
XFSFIELD fieldname*
BEGIN
(required) POSITION x, Horizontal position (relative to left side of form)
y Vertical position (relative to top of form)
FOLLOWS fieldname* Print this field directly following the field with the name <fieldname>; positioning information is ignored. See the description of WFS_CMD_PTR_PRINT_FORM.

If FOLLOWS is omitted then fields are printed in the order that they appear in the form definition.

SIDE side Side of form where field is positioned:
FRONT (default)
BACK
(required) SIZE width, Field width
height Field height
INDEX repeatcount, Count how often this field is repeated in the form, INDEX fields are fixed length. (default is no index field)
xoffset, Horizontal offset for next field
yoffset Vertical offset for next field
TYPE fieldtype Type of field:
TEXT (default)
MICR
OCR
MSF
BARCODE

GRAPHIC

PAGEMARK

SCALING scalingtype Information on how to size the GRAPHIC within the field:

BESTFIT (default) scale to size indicated

ASIS render at native size

MAINTAINASPECT scale as close as possible to size indicated while maintaining the aspect ratio and not losing graphic information.

SCALING is only relevant for GRAPHIC field types.

BARCODE hriposition Position of the HRI (Human Readable Interpretation) characters:

NONE (default)

ABOVE

BELOW

BOTH

The type of barcode to print is defined in the FONT field.

CLASS class Field class
OPTIONAL (default)
STATIC
REQUIRED
ACCESS access Access rights of field
WRITE (default)
READ
READWRITE
OVERFLOW overflow Action on field overflow:
TERMINATE (default)
TRUNCATE
BESTFIT (the service provider fits the data
into the field as well as it can)
OVERWRITE (a contiguous write)
WORDWRAP
STYLE style Display attributes as a combination of the following, ORed together using the "|" operator:
NORMAL (default)
BOLD
ITALIC
UNDER (single underline)
DOUBLEUNDER (double underline)
DOUBLE (double width)
TRIPLE (triple width)

QUADRUPLE (quadruple width)

STRIKETHROUGH

ROTATE90 (rotate +90 degrees clockwise)

ROTATE270 (rotate +270 degrees clockwise)

UPSIDEDOWN (upside down)

PROPORTIONAL (proportional spacing)

DOUBLEHIGH

TRIPLEHIGH

QUADRUPLEHIGH

CONDENSED

SUPERSCRIPT

SUBSCRIPT

OVERSCORE

LETTERQUALITY

NEARLETTERQUALITY

DOUBLESTRIKE

OPAQUE (If omitted then default attribute is transparent)

Some of these Styles may be mutually exclusive, or may combine to provide unexpected results.

CASE case Convert field contents to
NOCHANGE (default)
UPPER
LOWER
HORIZONTAL justify Horizontal alignment of field contents
LEFT (default)
RIGHT
CENTER
JUSTIFY
VERTICAL justify Vertical alignment of field contents
BOTTOM (default)
CENTER
TOP
COLOR color Color name
BLACK (default)
WHITE
GRAY
RED
BLUE
GREEN
YELLOW
LANGUAGE languageID Language used in this field – a 16 bit value (LANGID) which is a combination of a primary (10 bits) and a secondary (6 bits) language ID (This is the standard language ID in the Win32 API; standard macros support construction and decomposition of this composite ID)

If unspecified defaults to form definition LANGUAGE specification.

Font FONT fontname* Font name: This attribute is interpreted by the service provider. In some cases it may indicate printer resident fonts, and in others it may indicate the name of a downloadable font. For BARCODE fields it represents the barcode font name.

In some cases this predefines the following parameters:

Definition POINTSIZE pointsize Point size
Information CPI cpi Characters per inch
LPI lpi Lines per inch
FORMAT formatstring* This is an application defined input field describing how the application should format the data. This may be interpreted by the service provider.
INITIALVALUE value* Initial value, for GRAPHIC type fields, this value may contain the filename of the graphic image. The type of this graphic will be determined by the file extension (e.g. BMP for Windows Bitmap). Graphic file name may be full or partial path.

For example “C:\BSVC\BSVCLOGO.BMP” illustrates use of full path name.

A file name specification of “LOGO.BMP” illustrates partial path name. In this instance file is obtained from current directory.

END

The following diagrams illustrate the positioning and sizing of text fields on a form, and, in particular, the vertical alignment of text within a field using VERTICAL=TOP and VERTICAL=BOTTOM values in the field definition.

VERTICAL=TOP the upper boundary of the character drawing box (shown below) is positioned vertically to the upper field boundary.

VERTICAL=BOTTOM the baseline of the character drawing box (shown below)
is positioned vertically to the lower field boundary.

Definition of the character drawing box:

When more than one line of text is to be printed in a field, and the definition includes VERTICAL=BOTTOM, the vertical position of the first line is calculated using the specified (or implied) LPI value.