Version dev

# `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>

#### On this page