XFA Specification
Chapter 15, Template Specification
Template Reference
486
The decimal element
A content type element that describes a single unit of data content representing a number with a fixed
number of digits after the decimal.
<decimal
Properties:
fracDigits="2
|
integer"
id="xml-id"
leadDigits="-1
|
integer"
name="xml-id"
use="cdata"
usehref="cdata"
>
...pcdata...
</decimal>
The decimal element is used within the following other elements:
desc exObject extras items proto value variables
Note that the
decimal
element and the
float
element differ only in the user interface. They are
interchangeable in every other way.
Content
This element may enclose decimal-data which is an optional leading minus sign (Unicode character
U+002D), followed by a sequence of decimal digits (Unicode characters U+0030 - U+0039) separated by a
single period (Unicode character U+002E) as a decimal indicator.
To maximize the potential for data interchange, the decimal point is defined as '.' (Unicode character
U+002E). No thousands/grouping separator, or other formatting characters, are permitted in the data. The
template may specify a
picture clause
to provide a presentation more suitable for human consumption.
When no content is present, the content shall be interpreted as representing a null value, irrespective of
the value of the associtated
nullType
property in the data description.
The fracDigits property
The maximum number of digits (inclusively) following the decimal point to capture and store. The default
value (
-1
) causes the XFA processing application to record the number of fractional digits supplied in the
original value (but not as the value of
fracDigits
). For example, if the data associated with the
decimal
content type is "12.000", the unformatted data is printed or displayed as "12.000".
If
fracDigits="-1"
and a new value is supplied for the decimal element, the number of fractional digits
is reset accordingly. If the decimal value is changed as a result of a calculation, whether the number of
fractional digits is nullified or retained is implementation defined.
It is an error if the number of fractional digits in the decimal value exceeds the value of fracDigits.
The id property
A unique identifier that may be used to identify this element as a target.