SETATREFEXPR Function

Stores a value that is set through an action in the user interface (UI) or Automation.

Syntax

SETATREFEXPR ([ ** expr_opt ** ])

Parameters

Name Required/Optional Data Type Description
expr_opt
Optional
Varies
An expression that is replaced by the value or expression being assigned to the referenced cell in the SETATREF function. If not indicated, its initial value is 0 (zero).

Remarks

The value of a SETATREFEXPR expression can also be set from a SETATREF function in another cell that references the cell containing the SETATREFEXPR expression.

You are not limited to using the SETATREFEXPR function as a parameter to the SETATREF function.

Example 1

The following example uses the SETATREFEXPR function to ensure that a shape is as wide as its text.

Width =MAX(TEXTWIDTH(TheText),SETATREFEXPR())

Example 2

The following example shows how you can use the SETATREFEXPR function to cause your shapes to snap to a custom grid. The SETATREFEXPR formulas are placed in the PinX and PinY cells, causing the shape's pin to snap to the grid defined in User.GridX and User.GridY.

User.GridX =2 in

User.GridY =2 in

PinX =INT(SETATREFEXPR()/User.GridX + .5)*User.GridX

PinY =INT(SETATREFEXPR()/User.GridY + .5)*User.GridY

Example 3

For an example using the SETATREFEXPR function with the SETATREF function, see the SETATREF function.