set-values()

Previous Next

This method is supported for backward compatibility only.

Instead of using set-values()¬łto set a property to a value, refer to that property as a method call, providing the (new) property value as a parameter to the method call.

Set-values() sets the value of a property of the current object or a specified target object.

Syntax

set-values(<property>, <value>)

Parameters

property

The property to be (re)set. Refer to the property by using its internal name. To find the property's internal name, please refer to the Property Names vs. Internal Names list in the Property Reference section.

value

The value that the property is to have.

Examples

set-values(background, green)

action-other-control(<-student, set-values(background, blue))

NOTE 1:

This method changes property settings for the current window instance only. The window class or object class is not affected. The effect of set-values() therefore ends with the user session, or when the window is removed from the workspace cache.

NOTE 2:

If a target object is specified, it must exist within the current window or another window currently in the workspace (i.e. opened on-screen).