User Tools

Site Tools


header_page_or_group_header_structure_.htm
Navigation:  Language Reference > 7 - Reports > Report Structures >====== HEADER (page or group header structure) ====== Previous pageReturn to chapter overviewNext page
HEADER ,AT( ) [,FONT( )] [,ABSOLUTE] [,PAGEBEFORE( )] [,PAGEAFTER( )]
[,WITHPRIOR( )] [,WITHNEXT( )] [,ALONE] [,USE( )] [,COLOR( )] [,TOGETHER]
controls
END

blk2blue.jpg

HEADER Declares a page or group header structure.
AT Specifies the size and location of the HEADER (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 HEADER prints at a fixed position relative to the page (PROP:ABSOLUTE). Valid only on a HEADER within a BREAK structure.
PAGEBEFORE Declares the HEADER prints at the start of a new page after activating normal page overflow actions (PROP:PAGEBEFORE). Valid only on a HEADER within a BREAK structure.
PAGEAFTER Declares the HEADER prints, and then starts a new page by activating normal page overflow actions (PROP:PAGEAFTER). Valid only on a HEADER within a BREAK structure.
WITHPRIOR Declares the HEADER prints on the same page as the DETAIL, group HEADER, or FOOTER that immediately precedes it during printing (PROP:WITHPRIOR). Valid only on a HEADER within a BREAK structure.
WITHNEXT Declares the HEADER prints on the same page as the DETAIL, group HEADER, or FOOTER that immediately follows it during printing (PROP:WITHNEXT). Valid only on a HEADER within a BREAK structure.
ALONE Declares the (group) HEADER 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 HEADER structure in executable code (PROP:USE).
COLOR Specifies a background color for the HEADER and the default background color for the controls in the HEADER (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 HEADER structure declares the output which prints at the beginning of each page or group. A HEADER structure must be terminated with a period or END statement.

A HEADER structure that is not within a BREAK structure is a page header. Only one page HEADER is allowed in a REPORT. The page HEADER 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 HEADER is allowed in a BREAK structure.

Example:

CustRpt REPORT      !Declare customer report

        HEADER     ! begin page header declaration

         !report controls

        END        ! end header declaration  

Break1   BREAK(SomeVariable)

        HEADER    ! begin group header declaration

          !report controls

        END       ! end header declaration  

GroupDet  DETAIL    

          !report controls

         END       ! end detail declaration  

        END        ! end group break declaration  

       END         !End report declaration

header_page_or_group_header_structure_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)