sds_entget

struct sds_resbuf *sds_entget (const sds_name entity);


Get information about this object.


Given the name of an object, this function returns a result buffer with information about the object, such as layer, linetype, color, defining points, and so on. Note that the color, linetype, thickness, attributes follow flag, and entity handle are returned only when their value differs from the default value. The result buffer gives the group code as the restype and the value as the resval.

The sds_entget function returns x,y,z coordinates as a single point value in RPOINT and not as separate x, y, and z groups, as with DXF codes.

Before using sds_entget on polyline vertex entities, read the polyline's entity header because width information can be lost when the most-recently processed polyline object is different than the one the vertex belongs to.

The argument entity represents the name of the object whose information you wish to retrieve. If that object is not present in the current drawing, sds_entget returns NULL.

This function returns a linked list of result buffers with the information for one of the following: SDS_RTCAN, SDS_RTERROR, SDS_RTKWORD, SDS_RTNONE, or RTNORM.

Example

sds_name entname1;

sds_point point1;

struct sds_resbuf *entlist;

sds_entsel("\nPick an object: ",entname,point1);

entlist=sds_entget(entname);      

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)

sds_entgetx

sds_entmod