vlr-sysvar-reactor (AutoLISP/ActiveX)

Constructs an editor reactor object that notifies of a change to a system variable

Supported Platforms: Windows only

Signature

(vlr-sysvar-reactor data callbacks)
data

Type: Integer, Real, String, List, VLA-object, safearray, variant, T, or nil

Any AutoLISP data to be associated with the reactor object; otherwise nil if no data.

callbacks

Type: List

A list of pairs of the following form:

(event-name . callback_function)

  • event-name is one of the following SysVar reactor events:

    SysVar reactor events

    Event name

    Description

    :vlr-sysVarWillChange

    AutoCAD is about to change the value of a system variable.

    :vlr-sysVarChanged

    The value of a system variable has changed.

  • callback_function is a symbol representing a function to be called when the event fires. Each callback function accepts two arguments:

    reactor_object -- The VLR object that called the callback function.

    list -- A list of extra data elements associated with the particular event. The contents of this list for particular events are shown in the “SysVar reactor callback data” table.

    SysVar reactor callback data

    Name

    List length

    Parameters

    :vlr-sysVarWillChange

    1

    A string identifying the system variable name.

    :vlr-sysVarChanged

    2

    First parameter is a string identifying the system variable name.

    Second parameter is symbol indicating whether the change was successful (T if successful, nil if not).

Return Values

Type: VLR object

The reactor_object argument from the callback_function.

Examples

N/A

Related Concepts