FOOTER (page or group footer structure)

Top  Previous  Next

 

 

FOOTER

,AT( ) [,FONT( )] [,ABSOLUTE] [,PAGEBEFORE( )] [,PAGEAFTER( )]

 

 

[,WITHPRIOR( )] [,WITHNEXT( )] [,ALONE] [,USE( )] [,COLOR( )] [,TOGETHER]

 

controls

 

 

END

 

FOOTER

Declares a page or group footer structure.

AT

Specifies the size and location of the FOOTER (PROP:AT).

FONT

Specifies the default font for all controls in this structure (PROP:FONT). If omitted, the REPORT's FONT attribute (if present) is used, or else the printer's default font is used.

ABSOLUTE

Declares the FOOTER prints at a fixed position relative to the page (PROP:ABSOLUTE). Valid only on a FOOTER within a BREAK structure.

PAGEBEFORE

Declares the FOOTER prints at the start of a new page, after activating normal page overflow actions (PROP:PAGEBEFORE). Valid only on a FOOTER within a BREAK structure.

PAGEAFTER

Declares the FOOTER prints, and then starts a new page by activating normal page overflow actions (PROP:PAGEAFTER). Valid only on a FOOTER within a BREAK structure.

WITHPRIOR

Declares the FOOTER prints on the same page as the DETAIL, group HEADER, or FOOTER that immediately precedes it during printing (PROP:WITHPRIOR). Valid only on a FOOTER within a BREAK structure.

WITHNEXT

Declares the FOOTER prints on the same page as the DETAIL, group HEADER, or FOOTER that immediately follows it during printing (PROP:WITHNEXT). Valid only on a FOOTER within a BREAK structure.

ALONE

Declares the (group) FOOTER structure must be printed on a page without FORM, (page) HEADER, or (page) FOOTER structures (PROP:ALONE).

USE

A field equate label to reference the FOOTER structure in executable code (PROP:USE).

COLOR

Specifies a background color for the FOOTER and the default background color for the controls in the FOOTER (PROP:COLOR).

TOGETHER

Specifies that the DETAIL, or group HEADER or FOOTER structure (contained within a BREAK structure), is to only print on a single page, rather than being automatically split if there is not sufficient room for it (PROP:Together).

controls

Report output control fields.

The FOOTER structure declares the output which prints at the end of each page or group. A FOOTER structure must be terminated with a period or END statement.

A FOOTER structure that is not within a BREAK structure is a page footer. Only one page FOOTER is allowed in a REPORT. The page FOOTER is automatically printed whenever a page break occurs, at the page-relative position specified by its AT attribute.

The BREAK structure defines a group break. It may contain its own HEADER, FOOTER, and DETAIL structures, and/or other nested BREAK structures. It may also contain multiple DETAIL structures. The HEADER and FOOTER structures that are within a BREAK structure are the group header and footer. They are automatically printed when the value in a specified group break variable changes, at the next position available in the detail print area (specified by the REPORT's AT attribute). Only one FOOTER is allowed in a BREAK structure.

Example:

CustRpt  REPORT        !Declare customer report

        FOOTER       !begin page FOOTER declaration

          !report controls

        END          !end FOOTER declaration

Break1    BREAK(SomeVariable)

GroupDet   DETAIL  

           !report controls

          END         !end detail declaration

          FOOTER      !begin group footer declaration

           !report controls

          END         !end footer declaration

         END          !end group break declaration

        END           !End report declaration