Livecycle

exclGroup

The exclGroup object describes a mutual exclusion relationship between a set of containers.

An exclusion group is used to cause a set of radio buttons boxes to be mutually exclusive. When a 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 deactivated.

Each member of the exclusion group is associated with an on value and an off value. When a member is activated, it assumes the on value. 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 member of the exclusion group in the form causes each member’s value to be set to its on or off value, as appropriate. Similarly, assigning the on value to a member of the exclusion group 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 only if the value matches the on value for that member.

Hierarchy of objects

 

Model	Parent objects	Current object	Child objects
Form Model	area pageArea proto subform	exclGroup	assist bind border calculate caption connect desc	event extras field margin para setProperty traversal validate

Parent class

node class

Properties

 

Name	Description	Type	Access
{default}	Represents the actual value stored by an object.	String	Read /Write
access	Controls user access to the contents of a container object, such as a subform.	String	Read /Write
accessKey	Specifies an accelerator key that is used by an interactive application to move the input focus to a particular field element.	String	Read /Write
anchorType	Specifies the location of the container’s anchor point when it is placed by using a positioned layout strategy.	String	Read /Write
borderColor	Specifies the border color value for this field.	String	Read /Write
borderWidth	Specifies the border width for this field.	String	Read /Write
colSpan	Specifies the number of columns spanned by this object when used inside a subform with a layout type of row.	String	Read /Write
fillColor	The background color value for this field.	String	Read /Write
h	A measurement of the height for the layout.	String	Read /Write
hAlign	Specifies the horizontal text alignment.	String	Read /Write
layout	Specifies the layout strategy to be used by this object.	String	Read /Write
mandatory	Specifies the nullTest value for the field.	String	Read /Write
mandatoryMessage	Specifies the mandatory message string for this field.	String	Read /Write
maxH	Specifies the maximum height for layout purposes.	String	Read /Write
maxW	Specifies the maximum width for layout purposes.	String	Read /Write
minH	Specifies the minimum height for layout purposes.	String	Read /Write
minW	Specifies the minimum width for layout purposes.	String	Read /Write
presence	Specifies an object’s visibility.	String	Read /Write
rawValue	Specifies the unformatted value of the current object.	String	Read /Write
relevant	Controls whether a form object is included when the form is printed.	String	Read /Write
transient	Specifies whether the processing application must save the value of the exclusion group as part of a form submission or save operation.	String	Read /Write
use	Invokes a prototype.	String	Read /Write
usehref	Invokes an external prototype.	String	Read /Write
validationMessage	Specifies the validate message string for this field.	String	Read /Write
vAlign	Specifies the vertical text alignment.	String	Read /Write
w	A measurement specifying the width for the layout.	String	Read /Write
x	Specifies the X coordinate of the container’s anchor point relative to the top-left corner of the parent container when placed with positioned layout.	String	Read /Write
y	Specifies the Y coordinate of a container’s anchor point relative to the top-left corner of the parent container when placed with positioned layout.	String	Read /Write

Methods

 

Name	Description	Returns
execCalculate	Executes the calculate script of the field.	Empty
execEvent	Executes the event script of the object.	Empty
execInitialize	Executes the initialize script of the field.	Empty
execValidate	Executes the validate script of the field.	Empty
selectedMember	Returns the selected member of an exclusion group.	Object

exclGroup