acdbEntGet

C++

struct resbuf * acdbEntGet(
    const ads_name ent
);

File

acedads.h

Description

Retrieves the specified entity from the drawing database and returns its definition data as a linked list of result buffers. This function is used also to examine dictionaries.

The restype field of each item in the list is assigned an AutoCAD DXF group code. The first item will have a restype of -1, indicating that it contains the entity name in resval.rlname.

As with DXF, acdbEntGet() returns entity header items (the color, linetype, thickness, attributes-follow flag, and entity handle) only if their value differs from the default. Unlike DXF, acdbEntGet() returns the optional entity definition fields, whether or not they are equal to their defaults. This simplifies the processing; an application can assume that these fields are present.Also unlike DXF, acdbEntGet() returns associated X, Y, and Z coordinates as a single point value (resval.rpoint), not as separate X (10), Y (20), and Z (30) groups. The restype value will be the group number of the X coordinate (in the range 10-19).

If it cannot find ent in the current database, acdbEntGet() returns NULL. When acdbEntGet() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Before performing an acdbEntGet() on vertex entities, you should read or write the polyline entity's header. If the most recently processed polyline entity is different from the one to which the vertex belongs, width information (the 40 and 41 groups) can be lost.

To access the object state of a symbol table or symbol table entry, pass the entity name to acdbEntGet().

Parameters