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)
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.