paginate

Creates a page break.

Available in:

Apps (win)	Apps (char)	Reportwriter	RPC	Standalone PL
	X			X

Syntax

void paginate( [header] [| break] [| footer]  )
keyword     header,break,footer

Description

Creates the following page break for each keyword:

footer	Appends the current block's page footer (if any).
break	Writes out the report page, clears report page, resets line count (`G.LINENUMBER = G.PAGEHEADERLINES`) and increases page number (`G.PAGENUMBER = G.PAGENUMBER + 1`).
header	Inserts the current block's page header (if any).

Notes

If no block is currently active (for example, the main trigger), then the first block's page header is printed. If a different header is required, remove paginate(header) from the main trigger and put it in the PRE-BLOCK trigger of the first block.

Example

By default the page trigger contains the single statement:

paginate(footer|break|header);

For special effects, the page trigger can be changed to perform actions such as resetting offsets.