Share

AcRxDynamicLinker::loadApp

C++

virtual bool loadApp(
    const ACHAR * appName, 
    AcadApp::LoadReasons al, 
    bool printit, 
    bool asCmd = false
) = 0;

Description

This function loads the appName ObjectARX program. appName is the application name as set in the operating system registry. If the ObjectARX application does not have an entry in the registry, or if the registry entry has the AcadApp::kLoadDisabled load reason set, or if any of the the LoadReasons in reasons do not match the LoadReasons in the application's registry entry, then this function will be unable to load the application.

If printit is true, then a message is sent to the AutoCAD text screen indicating the success or failure of the load operation.

When asCmd is kTrue, loading can happen only once. A second attempt to load will return kFalse. The reference count for the application is not increased in this case. When asCmd is kFalse, it's possible to call this method more than once and still get a successful return value. When the .arx you want to load is already loaded, this method will simply increment the reference count for the application.

The function returns true if the module was successfully found and loaded; otherwise, it returns false.

Parameters

Parameters Description
appName Input null-terminated string which is the application name (as set in the system registry) of the ObjectARX module to load
al Input AcadApp::LoadReasons values to use during this load
printit Input Boolean indicating whether or not to print load status message
asCmd Input Boolean indicating whether to load the application as if by user command

Links

AcRxDynamicLinker

Was this information helpful?