Navigation: Language Reference > 7 - Reports > Report Structures >====== FORM (page layout structure) ====== | |
FORM ,AT( ) [,FONT( )] [,USE( )] [,COLOR( )] | |
controls | |
END |
FORM | Declares a report structure which prints on each page. |
AT | Specifies the size and location, relative to the top left corner of the page, of the FORM (PROP:AT). |
FONT | Specifies the default font for all controls in this report structure (PROP:FONT). If omitted, the REPORT's FONT attribute (if present) is used, or else the printer's default font is used. |
USE | A field equate label to reference the FORM structure in executable code (PROP:USE). |
COLOR | Specifies a background color for the FORM and the default background color for the controls in the FORM (PROP:COLOR). |
controls | Report output control fields. |
FORM declares a report structure which prints on every page of the report (except pages containing DETAIL structures with the ALONE attribute). A FORM structure must be terminated with a period or END statement. Only one FORM is allowed in a REPORT structure. The FORM structure automatically prints during page overflow.
The printed output of the FORM is determined only once at the beginning of the report. The page positioning of the FORM does not affect the page positioning of any other report structure. Once printed, all other structures may “overwrite” the FORM. Therefore, FORM is most often used to design pre-printed forms which are filled in by the subsequent HEADER, DETAIL, and FOOTER structures. It may also be used to generate “watermarks” or page border graphics.
Example:
CustRpt REPORT !Declare customer report
FORM
IMAGE('LOGO.BMP'),AT(0,0,1200,1200),USE(?I1)
STRING(@N3),AT(6000,500,500,500),PAGENO
END
GroupDet DETAIL
!report controls
END
END !End report declaration