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.
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
|