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
|
