<u>Sample 4: Repeated Framing</u>

9.5 Frame Definition

XFSFRAME		framename*
BEGIN
(required)	POSITION	x,	Horizontal position of top left corner of the frame (relative to left side of form)
		y	Vertical position of top left corner of the frame (relative to top of form)
	FRAMES	fieldname*	Frames the field with the name <fieldname>, positioning information is ignored. The frame surrounds the complete field, not just the printed data. If the field is repeated, the frame surrounds the first and last fields that are printed.
	SIDE	side	Side of form where this frame is positionned: FRONT (default) BACK
(required)	SIZE	width,	Frame width in base horizontal units for the form
		height	Frame height in base vertical units for the form
	REPEATONX	repeatcount,	Count how often this frame is repeated horizontally in the form.
		xoffset	Horizontal offset for next frame in base horizontal units.
	REPEATONY	repeatcount,	Count how often this frame is repeated vertically in the form.
		yoffset	Vertical offset for next frame in base vertical units.
	TYPE	frametype	Type of frame: RECTANGLE (default) ROUNDED_CORNER ELLIPSE
	CLASS	class	Frame class: STATIC (default) OPTIONAL (The frame is printed only if its name appears in the list of field names given as parameter to the WFSExecute command. In this case, the name of the frame must be different from all the names of the fields.)
	OVERFLOW	overflow	Action on frame overflowing the form: TERMINATE (default) TRUNCATE BESTFIT (the service provider fits the frame into the media as well as it can)
	STYLE	style	Frame line attributes: SINGLE_THIN (default) DOUBLE_THIN SINGLE_THICK DOUBLE_THICK DOTTED
	COLOR	color	Color name for frame lines: BLACK (default) WHITE GRAY RED BLUE GREEN YELLOW
	FILLCOLOR	color	Color name for interior of frame: BLACK WHITE (default) GRAY RED BLUE GREEN YELLOW
	FILLSTYLE	style	Style for filling the interior of frame: NONE (default) SOLID Solid color BDIAGONAL Downward hatch (left to right) at 45 degrees CROSS Horizontal and vertical crosshatch DIAGCROSS Crosshatch at 45 degrees FDIAGONAL Upward hatch (left to right) at 45 degrees HORIZONTAL Horizontal hatch VERTICAL Vertical hatch
frame title	TITLE	fieldname*	Uses the field with the name <fieldname> as the title of the frame. Positioning information of the field is ignored.
definition	HORIZONTAL	justify	Horizontal alignment of the frame title: LEFT (default) CENTER RIGHT
information	VERTICAL	justify	Vertical alignment of the frame title: TOP (default) BOTTOM
END

The XFSFRAME definition provides a means for framing a XFSFIELD text field. The basic concept of a XFSFRAME definition and corresponding XFSFIELD definition is illustrated as follows:

When the XFSFRAME frames a field, its positioning and size information are ignored. Instead, service providers should position the top left corner of the frame one horizontal base unit to the left and one vertical base unit to the top of the top left corner of the field. Similarly, service providers should size the frame so that it bottom right corner is one base unit below and to the right to the field. For instance, if the form units are ROWCOLUMN, and a XFSFRAME “A” is said to FRAME the XFSFIELD “B” which is positioned at row 1, column 1 with a size of 1 row and 20 columns, the frame will be drawn from row 0, column 0 to row 3, column 22.

The horizontal and vertical positioning of a frame title override the position of the named XFSFIELD. For instance, if a XFSFRAME “A” is said to have the XFSFIELD “B” as its title, with the default horizontal and vertical title justification, it is just as if XFSFIELD “B” had been positioned at the top left corner of the frame. Note that the SIZE information for the title field still is meaningful: it gives the starting and/or ending positions of the frame lines.

The SIDE attributes of the XFSFRAME and the XFSFIELDs it refers to must agree.

The width of the lines and the interval between the lines of doubled frames are vendor specific. Whether the lines are drawn using graphics printing or using pseudo-graphic is vendor specific. However, service provider are responsible for rendering intersecting frames.

Depending on the printer technology, framing of fields can substantially slow down the print process.

Support of framing by a service provider or the device it controls is not mandatory to be WOSA/XFS compliant.

Sample 1: Simple framing

XFSFORM "Multiple Balances"	When printed with the following field list:
BEGIN	Account[0]=0123456789123001
UNIT INCH, 16, 16	Account[1]=0123456789123002
SIZE 91, 64	Account[2]=0123456789123003
VERSION 1, 0, "13/09/96", "WOSA/XFS"	Balance[0]=$17465.12
LANGUAGE 0x0409	Balance[1] =$2458.23
XFSFIELD "Account Title"	Balance[2]=$6542.78
BEGIN	Will print:
POSITION 15, 4	Account	Balance
SIZE 30, 4	0123456789123001	$17465.12
CLASS STATIC	0123456789123002	$2458.23
HORIZONTAL CENTER	0123456789123003	$6542.78
INITIALVALUE "Account"
END
XFSFIELD "Balance Title"	When printed with the following field list:
BEGIN	Account[0]=0123456789123001
POSITION 45, 4	Balance[0]=$17465.12
SIZE 30, 4	Will print:
CLASS STATIC
HORIZONTAL CENTER	Account	Balance
INITIALVALUE "Balance"	0123456789123001	$17465.12
END

XFSFIELD "Account"
BEGIN
POSITION 15, 8
SIZE 30, 4
INDEX 10, 0, 3
END //"Account"
XFSFIELD "Balance"
BEGIN
POSITION 45, 8
SIZE 30, 4
INDEX 10, 0, 3
HORIZONTAL RIGHT
END //"Balance"
XFSFRAME "Account Title"
BEGIN
POSITION 15, 4
FRAMES "Account Title"
SIZE 30, 4
STYLE DOUBLE_THIN
END
XFSFRAME "Balance Title"
BEGIN
POSITION 45, 4
FRAMES "Balance Title"
SIZE 30, 4
STYLE DOUBLE_THIN
END
XFSFRAME "Account"
BEGIN
POSITION 15, 8
FRAMES "Account"
SIZE 30, 34
STYLE DOUBLE_THIN
END
XFSFRAME "Balance"
BEGIN
POSITION 45, 8
FRAMES "Balance"
SIZE 30, 34
STYLE DOUBLE_THIN
END
END

Sample 2: Framing with title


XFSFORM "Bank Details"		When printed with the following field list:
BEGIN		Owner = Mr/Mrs Jean Leroy
UNIT INCH, 16, 16		21560 Hagerty Road
SIZE 121, 64		Troy, MI.
VERSION 1, 0, "13/09/96", "WOSA/XFS Editor"
LANGUAGE 0x0409		will print:
XFSFIELD "Owner Frame Title"
BEGIN
POSITION 24, 9
SIZE 27, 3		Mr/Mrs Jean Leroy
CLASS STATIC		21560 Hagerty Road
HORIZONTAL CENTER		Troy, MI.
VERTICAL CENTER
INITIALVALUE "Account Owner"
END
XFSFIELD "Owner"
BEGIN
POSITION 20, 11
SIZE 35, 9
CLASS REQUIRED
VERTICAL TOP
END //"Owner"
XFSFRAME "Owner Frame"
BEGIN
POSITION 19, 10
FRAMES "Owner"
SIZE 37, 11
TITLE "Owner Frame Title"
HORIZONTAL CENTER
END
END

Sample 3: Framing with filled interior


XFSFORM "Bank Details"		When printed with the following field list:
BEGIN		Owner = Mr/Mrs Jean Leroy
UNIT INCH, 16, 16		21560 Hagerty Road
SIZE 121, 64		Troy, MI.
VERSION 1, 0, "13/09/96", "WOSA/XFS Editor"
LANGUAGE 0x0409		will print:
XFSFIELD "Owner"
BEGIN
POSITION 20, 11
SIZE 35, 9
CLASS REQUIRED		Mr/Mrs Jean Leroy
VERTICAL TOP		21560 Hagerty Road
END		Troy, MI.
XFSFRAME "Owner Frame"
BEGIN
POSITION 19, 10
FRAMES "Owner"
SIZE 37, 11
FILLCOLOR GRAY
FILLSTYLE CROSS
END
END

Sample 4: Repeated Framing

XFSFORM "Smart Account Number"

When printed with the following field list:

BEGIN

Account Number[0]=0

UNIT INCH, 16, 16

Account Number[1]=1

SIZE 121, 64

Account Number[2]=2

VERSION 1, 0, "13/09/96", "WOSA/XFS Editor"

Account Number[3]=3

LANGUAGE 0x0409

Account Number[4]=4

XFSFIELD "Account Number"

Account Number[5]=5

BEGIN

Account Number[6]=6

POSITION 20, 8

Account Number[7]=7

SIZE 4, 4

Account Number[8]=8

INDEX 12, 4, 0

Account Number[9]=9

HORIZONTAL CENTER

Account Number[10]=0

VERTICAL CENTER

Account Number[11]=1

END

XFSFRAME "A/N Frame"

BEGIN

POSITION 20, 8

will print

SIZE 4, 4

REPEATONX 12, 4

END