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

Child objects

Form Model

ref

Parent class

node class 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

// Ethnio survey code removed