acdbDictAdd

C++

int acdbDictAdd(
    const ads_name dictname, 
    const ACHAR* symname, 
    const ads_name newobj
);

File

acedads.h

Description

Adds a non-graphical object to the specified dictionary.

Note This function can be used to set an owner for an object created with acdbEntMakeX() (which is often desirable because objects and entities without owners are not written out to DWG or DXF file).

If acdbDictAdd() succeeds, it returns RTNORM. If dictname fails, it returns RTERROR. If acdbDictAdd() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Error conditions include the following:

• The object specified by newobj does not correspond to a valid non-graphical object

• The input dictionary key is already present for the specified dictionary (a duplicate key)
• The dictname specified does not correspond to an instance of AcDbDictionary.

Parameters