op.setRefCon

Syntax op.setRefCon (value)

Params value is an object of any scalar datatype, a value whose type is not outlineType, scriptType, menubarType, tableType, pictType or wptextType.

Action Establishes the refCon data attached to the current heading.

Returns True

Examples op.setRefCon (@notepad)

   » true

The address of the notepad outline is now attached to the current heading.

Errors If the target window does not contain an outline or a script, an error message will be generated.

Notes This is an advanced Frontier verb of primary interest to implementers and advanced scripters. It is not necessary to understand it to use Frontier effectively for most tasks.

Unlike other "op" verbs, op.setRefCon cannot be applied to menubar outlines. Menubar objects use the refCon mechanism internally to maintain the attached script.

See Also op.getRefCon

Discuss