XFA Specification
Chapter 15, Template Specification
Template Reference
573
The message element
A automation element that holds one or more sub-elements containing messages used with validations
and calculations.
<message
Properties:
id="xml-id"
use="cdata"
usehref="cdata"
>
Children:
<text>
</message>
[0..n]
The message element is used within the following other elements:
calculate proto validate
If the
message
element is a child of
validate,
it may contain multiple
text
elements, each of which
corresponds with a different type of validation. The
name
attribute of the text element associates the
message with the type of validation. Specifically, the child
text
element named
scriptTest
is used for
script validation, the one named
nullTest
is used for null validation, and the one
formatTest
is used
for format validation. It is erroneous to have more than one child element with the same name or with no
name. If the
message
element contains a single un-named
text
element, the message it contains is used
for all messages issued by the enclosing
validate
If the
message
element is a child of
calculate,
it contains a single
text
element, which is displayed as
specified in the calculate element's
override
attribute.
The id property
A unique identifier that may be used to identify this element as a target.
The text child
A
content
For more information see "The
The use property
Invokes another object in the same document as a prototype for this object. The content of this property is
either a SOM expression (which cannot start with '#') or a '#' character followed by an XML ID.
Starting with XFA 2.4 the object used as a prototype no longer needs to be the child of
proto
. Any object
of the appropriate class can be used as a prototype.
If both
use
and
usehref
are non-empty
usehref
takes precedence.
The usehref property
Invokes an external object as a prototype for this object. The content of this property is an URL, followed
by '#', followed by either an XML ID or by som(SOM_expr) where
SOM_expr
represents a SOM expression.