| **Navigation:**  [[introduction.htm|Language Reference]] > 7 - Reports > Report Structures >====== HEADER (page or group header structure) ====== | [[form  page layout structure .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[printer control properties.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

|  | **HEADER** ,**AT( )** | [,**FONT( )**] [,**ABSOLUTE**] [,**PAGEBEFORE( )**] [,**PAGEAFTER( )**] |
|  |  | [,**WITHPRIOR( )**] [,**WITHNEXT( )**] [,**ALONE**] [,**USE( )**] [,**COLOR( )**] [,**TOGETHER**] |
|  | //controls// |  |
|  | **END** |  |

{{blk2blue.jpg|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**