XFA Specification
Chapter 15, Template Specification
Template Reference
507
The exclGroup element is used within the following other elements:
area pageArea proto subform
An exclGroup is used to cause a set of radio buttons or check boxes to be mutually exclusive. This means
that when the user activates one member of the set the other members are automatically deactivated. For
example, if the set consists of radio buttons, clicking one button causes the other buttons to be released.
Each member of the exclusion group has an "on" value and "off" value associated with it. When the
member is activated it assumes the "on" value and when it is deactivated it assumes the "off" value. The
"on" value for each member of a particular exclusion group must be unique.
Selecting one of the members of the exclusion group in the user interface causes each member's value to
be set to its "on" or "off" value as appropriate. Similarly assigning a value to a member of the exclusion
group, if the value assigned is the "on" value, causes the other members to be deactivated.
Alternatively a value may be assigned to the exclusion group itself. In this case each member is activated if
and only if the value matches the "on" value for that member.
The access property
Controls user access to the contents.
nonInteractive
Allow the content to be loaded from the data document, but not updated interactively. The effect
is to behave (for this container) as though rendering to paper regardless of whether or not the
context is interactive. Calculations are performed at load time but the content is not subsequently
recalculated even if values upon which it depended change. Neither can the content be modified
by scripts or web service invocations.
open
Allow update without restriction. The interactive user may modify the container's content, and tab
or otherwise navigate into it. The container will produce
events.
protected
The processing application must prevent the user from making any direct changes to the
container's content. Indirect changes (e.g., via calculations) may occur. The container will not
participate in the tabbing sequence, though an application may allow the selection of text for
clipboard copying. A protected container will not generate any events.
readOnly
The processing application must not allow the user to make direct changes to the container's
content. Indirect changes (e.g., via calculations) may occur. The container shall participate in the
tabbing sequence and must allow the user to view its content, possibly scrolling through that
content if required. The user must be able to select the container's content for clipboard copying.
The container shall also generate a subset of events (those not associated with the user making
direct changes to the content).
The accessKey property
An accelerator key used by an interactive application to move the input focus to a particular field element.
The value of this attribute is a single character. When the user synchronously presses the platform-specific
modifier key and the single character, the XFA processing application sets the focus to this field. On
Windows systems, the modifier key is the Alt key; and on Mac systems, it is the Option key.