-appendPages

Change where pages are added when a container overflows.

Syntax

-appendPages

Description

When the process of merging the data with the form design is finished, many containers can be overflowing with instantiated panes. The pagination algorithm has the task of splitting such overflowed containers into pages. Normally those pages are inserted in the output right after the overflowing page. When the -appendPages option is specified, the overflow pages will be added to the end of all existing pages.

By the time the pagination algorithm begins, all mandatory pages will have been instantiated, regardless of whether their containers are over-full or not. One instance per mandatory page. Now each of the pages (or layouts), per the order of definition in Design, will be examined, overflow conditions will be detected and additional pages will be added as necessary. This -appendPages option simply defines where those pages will be added.

Suppose you had three-page layouts brilliantly named as Layout1, Layout2 and Layout3. Suppose they were all mandatory, and also that there was enough data that flowed into Layout1" that three instances of it (or of it and its designated overflow layout) were required. The result...

See Also

Pagination