Livecycle

setProperty

The setProperty object modifies a property of its parent object. A parent object can contain any number of setProperty objects.

The target property is a reference syntax expression that describes a single property of the parent object. This property identifies the node for which the value is to be set to the value identified by the ref object and connection property. For example, the target specified to set the toolTip for a field would be access.toolTip.

Within the parent container, there are no restrictions on which properties the setProperty object can target. However, the setProperty object cannot target the properties of nested containers.

The application of the setProperty object is a template operation. The reference is resolved and the data value is applied to the target property when generating the form as a result of a merge. There is no permanent link between the data node and the property. Subsequent changes to the data are not propagated to the target property unless another merge occurs.

Note:

Using the setProperty object to target bind related properties, such as the bind object or #name, is unlikely to be useful, because the setProperty application occurs after the merge process has occurred.

Hierarchy of objects

 

Model	Parent objects	Current object	Child objects
Form Model	draw exclGroup field proto subform	setProperty	ref

Parent class

node class

Properties

 

Name	Description	Type	Access
connection	Specifies the name of the associated connection control in the connection set.	String	Read /Write
target	Specifies the object upon which the action will occur.	String	Read /Write

Methods

None

setProperty