7.4

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
Snapping Points
Snapping point are points on an object or group that you use to connect one object or group to another such that changes to
the size or position of one affects all those snapped to it. As a simple example, consider the second page of a form letter in
which the last paragraph (a text object)is followed by a signature (a picture object). The last paragraph can vary in length but
the signature must always appear in the same position relative to the last line of the paragraph. You can accomplish this by
connecting the text object to the picture object using snapping points.
If you snap an object to the bottom of a text object whose contents vary in length, and you want that object to always
remain in the same position relative to the last line of text in the text object, be sure you select Dynamic height in the
Basic attributes of the text object. Recall that the Dynamic height option is available only when Word wrap is on.
PlanetPress Design Objects
©2010 Objectif Lune Inc - 128 -