XFA Specification
Chapter 15, Template Specification
Template Reference
456
The breakBefore element
An element that controls actions to be taken before laying down the contents of the parent object.
<breakBefore
Properties:
id="xml-id"
leader="cdata"
startNew="0
|
1"
target="cdata"
targetType="auto
|
contentArea
|
pageArea"
trailer="cdata"
use="cdata"
usehref="cdata"
>
<script>
[0..1]
</breakBefore>
The breakBefore element is used within the following other elements:
proto subform subformSet
When layout of the parent object is about to start and this element contains a non-empty script the script
is evaluated. If the script returns false no break occurs and layout proceeds using the current layout
container. However if the script returns true, or if there is no script, or the script is empty, a break occurs
and various actions occur under control of the other properties of this element.
The id property
A unique identifier that may be used to identify this element as a target.
The leader property
The value of this property is either a SOM expression (which can not start with '#') or a '#' followed by an
XML ID. The SOM expression or XML ID points to a subform or subform set to be laid down before the
content of the parent object but after other actions of the break such as starting a new page. When this
property is empty or blank no leader is laid down.
The script property
An
automation
For more information see "The
The startNew property
Controls whether or not to start a new layout container if the current layout container matches the target
specification.
0
If the current layout container matches the target specification continue filling the same
container. Only start a new layout container when the current one does not match the target
specification.