ClearPage
since version 4.5.14
Finishes the current page.
Child elements
(none)
Parent elements
AtPageCreation, AtPageShipout, Case, Contents, ForAll, Function, Loop, Otherwise, Record, SavePages, SetVariable, Until, While
Attributes
force(optional)-
Force the creation of a new page when multiple consecutive ClearPage commands occur.
matter(optional)-
Set the matter for the new page.
openon(optional)-
The next current page will be a left or a right page. E.g. when on page 1 and openon="right" then page 2 is empty and the next current page is 3.
left-
The next objects will be placed on a left page.
right-
The next objects will be placed on a right page.
pagetype(text, optional)-
The name of the next page type that should be used. If an InsertPage follows the NextPage, the pagetype is used for the first inserted page.
skippagetype(text, optional)-
The pagetype of the blank page if inserted (see the attribute openon).
Remarks
This used to be the command <NewPage>. NewPage is kept internally for backwards compatibility, but had incorrect behaviour.
Example
<Record element="data">
<PlaceObject>
<Textblock>
<Paragraph><Value>This is page 1</Value></Paragraph>
</Textblock>
</PlaceObject>
<ClearPage openon="right"/>
<PlaceObject>
<Textblock>
<Paragraph><Value>And this is page 3</Value></Paragraph>
</Textblock>
</PlaceObject>
</Record>