7.5

Note that in both cases, the specific line number you define in the Data properties of the object or objects is not important. You
determine the start and end lines for the repeats when you set up the line repeat. When you do this, PlanetPress Design auto-
matically sets the values of the From line and To line boxes in the Data properties of each object to &current.line. This
ensures the data selection changes with each repeat. If you use a Custom data selection, you must manually adjust the ref-
erences to the line (or record) to &current.line; if you do not make this adjustment, the Custom data selection remains the
same for all repeats.
The start and end lines you define in the Repeat properties also determines the total number of repeats. In the Repeat prop-
erties you also define the layout you want to create, the horizontal and/or vertical order in which you want the data selection
changes to occur. An Iteration condition can also be applied to determine whether the data selections that reference the cur-
rent line or record that are being processed appear in the output.
When is a Line Repeat useful?
A line repeat is useful when all of the following are true:
l The input data contains two or more contiguous lines or records with the same structure.
l In your document, you want to reference the data on those lines or records by proceeding consecutively, one line or
record at a time.
l You cannot accomplish your goal only by creating data selections that cover the line range.
l The input data contains more text than a PlanetPress Design document page can accommodate, due to layout or paper
size constraints.
When PlanetPress Design is processing an object with repeat properties and this condition becomes true, it stops repeating the
object, performs the remaining objects on the document page and then performs the whole page once again, only this time
using the surplus data. When all the data included in the current data page has been printed, PlanetPress Design stops repeat-
ing that page and goes on to the other pages that may be included in the document.
The fact that the same page is repeated to accommodate the surplus data does not mean that the initial page and the addi-
tional pages have to have the same appearance. The status of the condition to exit and overflow may be used to turn on
objects that were turned off on the first page and vice versa. Note that all these objects must belong to the same group.
List of available variables when overflowing:
Variable Name Type
Available
on
Description
&current.overflowcount integer
Object &
Page
Indicates the overflow page number. Is always 0 on the first page and non-over-
flowing pages. Is the same before and after the object, wherever it is placed on the
page or document order.
&current.overflowing boolean
Object &
Page
A true/false variable indicated if you are in an overflow loop. Is always false before
the first overflow loop, true for all objects and pages during iteration, and false
after the object after the last overflow loop.
&current.iteration integer
Object
only
The current iteration of the whole object, reset only when the overflow is finished
on all pages. Useful for determining the total number of objects repeated in all
pages.
&iterationcount integer
Object
only
The current iteration on this page, reset on ever new overflow page. Most common
use is to determine the maximum number of objects on the page in the overflow
condition, e.g. =&iterationcount >= 15
PlanetPress Design Objects
©2010 Objectif Lune Inc - 118 -