Share

ads_queueexpr

C++

ACCORE_PORT int ads_queueexpr(
    const ACHAR* expr
);

File

acedads.h

Description

This function queues up the LISP expression expr to be executed the next time AutoCAD is quiescent and able to evaluate LISP expressions

This function should only be called from within the kLoadDwgMsg case in your acrxEntryPoint() function. Queued LISP expressions will be executed after the (s::startup) has been executed.

Multiple calls to ads_queueexpr() from the kLoadDwgMsg callback are perfectly acceptable. They get queued up in the order of the calls.

Parameters

Parameters Description
expr Input the LISP expression to be evaluated. Must be a fully expanded expression, with outer parentheses. It may contain the (command) function.

Returns

Returns RTNORM if successful; otherwise, an error is returned.

Notes

Do not use ads_queueexpr() in any context other then the kLoadDwgMsg case of acrxEntryPoint(). To do so will have unpredictable results, and may even be damaging, because the queue may not be looked at until active AutoLISP evaluations, MENU items, and/or SCRIPT executions are all finished.

Previous Declaration

AutoCAD 2015 through 2025

int ads_queueexpr(const ACHAR* expr);

AutoCAD 2014 and Earlier

int ads_queueexpr(ACHAR* expr);

Was this information helpful?