control-set-values()

This method is supported for backward compatibility only.

Instead of using control-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.

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

Syntax

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

In some cases you need to know the internal representation of the allowed values that certain properties have. The prompt displayed in the Property Inspector may not be the value that is actually stored.

For a list of these internal resource values, please refer to the Allowed Property Values vs Internal Resource Values list in the Property Reference section .

Examples

control-set-values(background, green)

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

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

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

You can use the control-set-values() method for a specific property if:

To insert a date value into a field associated with a DATE data type, you need to use the date format YYYY/MMDDHH24MISS, for example:

control-set-values(<property>, to_char(SYSDATE, 'YYYY/MMDDHH24MISS'))