XFA Specification
Chapter 15, Template Specification
Template Reference
561
The keep element
An element that describes the constraints on keeping subforms together within a page or content area.
<keep
Properties:
id="xml-id"
intact="none
|
contentArea
|
pageArea"
next="none
|
contentArea
|
pageArea"
previous="none
|
contentArea
|
pageArea"
use="cdata"
usehref="cdata"
>
<extras>
[0..1]
</keep>
The keep element is used within the following other elements:
proto subform
The extras property
An enclosure around one or more sets of custom properties. The content of this element may be used by
custom applications.
For more information see "The
The id property
A unique identifier that may be used to identify this element as a target.
The intact property
This property specifies the constraints on keeping a subform intact within a content area or page.
Note that the default value for this property is not fully depicted in the syntax summary above. There is no
single default, instead it is context-sensitive. When the parent container's layout is "tb", "lr-tb", or "table"
the default value is "none". When the parent container's layout is "position" or "row" the default value is
"contentArea". Note that the default is (re-)computed at the moment the API call to get the value is made
or at the moment the layout operation is invoked.
none
The determination of whether a subform will be rendered intact within a content area or page will
be delegated to the processing application. It is possible that the subform will be split across a
content area or page. This is the default when the parent container's layout is "tb", "lr-tb", or "table".
contentArea
The subform is requested to be rendered intact within a content area. This is the default when the
parent container's layout is "position" or "row".
pageArea
The subform is requested to be rendered intact within a page.