Set reference

Command groupFlag affectedReversibleExecute on clientPlatform(s)
CalculationsNONOYESAll

Syntax

Set reference
 
field-name
 to 
notation-or-calculation-for-an-item

Description

This command sets up and stores a reference to an item in a variable of type Item reference. It assigns an alias for an item of notation that you do not want to type each time the item is referenced in the code.

Note - for JavaScript client-executed methods this command is equivalent to Calculate.

Example

# declare local variable lRef of type Item reference in a window class

 
# set the local item reference variable lRef to a Balance field on a Page Pane

Set reference
 
lRef
 to 
$cinst.$objs
.
PagePane
.
$objs
.
Balance

 
# now you can set the text color of the Balance field to red using lRef

Do
 
lRef
.
$textcolor.$assign
(
kRed
)