ade_odaddrecord

Attaches data to an object.

int

ade_odaddrecord(

ads_name ename,

char* table);

Returns RTNORM or an error code.

ename	An AutoCAD object name.
table	The table name, which can be up to 25 characters long. It must be unique, contain no spaces, and start with an alphanumeric character.

Attaching data to an object is also called attaching a table to an object. This function attaches a new record in a specific table to a specific object. Typically, a record contains information about whatever it is that the object represents. For example, if a line in a drawing represents a section of pipe in a water system, an attached record could contain information about that section.

When a new record is attached, its fields contain default values that correspond to their field definitions. To get a field value, use ade_odgetfield; to change it, use ade_odsetfield. Field definitions are included in the table definition. See ade_oddefinetab for information about table definitions.

You can attach more than one record to the same object with additional calls to ade_odaddrecord. The additional records can be members of the same or different tables. If an object has only one record from a given table, the number of that record is 0. If you attach a second record from the same table, the number of that record is 1, and so on. Use ade_odrecordqty to find how many records of a given table are attached.

For example, if a section of water pipe is inspected at intervals, you could attach a number of records of the WATER INSPECTION table to the same line in the WATER drawing, and each record could contain the result of a different inspection.

The following sample creates a selection set of all entities in the current drawing using acedSSGet(). Each entity is then passed to ade_odaddrecord() with all required parameters. The result code returned by ade_odaddrecord() is displayed. Then it releases the resbuf, as required.

ads_name selectionSet;
ads_name ename;
char* pszOdTable = "table1";
acedSSGet("x", NULL, NULL, NULL, selectionSet);
long ssLength;
acedSSLength( selectionSet, &ssLength; );
for( int i = 0; i < ssLength; ++i )
{
    if( acedSSName(selectionSet, i, ename) == RTNORM )
    {
        int nResultCode = ade_odaddrecord(ename, pszOdTable);

        if (RTNORM == nResultCode) {
            acutPrintf(
                "\nThe specified record has been added.");
        }
        else {
            acutPrintf(
                "\nThe specified record has not been added.");
        }
    }
}