Lists the drawings attached to a specified drawing.
struct resbuf*
ade_dslist(
ade_id dwg_id,
ade_boolean nested);
Returns a list of drawing IDs or NULL.
| dwg_id | The drawing ID or ADE_NULLID. |
| nested | Drawing is nested or not. Values can be: ADE_TRUE or ADE_FALSE. |
If the dwg_id argument is ADE_NULLID, this function returns drawing IDs for the drawings attached to the current drawing.
If the nested argument is ADE_TRUE, the list includes drawings that are directly attached and all nested drawings at every level below them. If the argument is ADE_FALSE, the list includes only drawings that are directly attached.
You must release the resbuf.
The following sample parses the resbuf returned by ade_dslist() and prints a list of attached drawing ID's. Then it releases the resbuf, as required.
struct resbuf* pAttachedDwgsRb = NULL;
pAttachedDwgsRb = ade_dslist(ADE_NULLID, 1);
if (NULL != pAttachedDwgsRb) {
int nDwg = 0;
struct resbuf* rb = pAttachedDwgsRb;
while(rb != NULL) {
++nDwg;
acutPrintf(
"\nAttached drawing # %d has the ID of: %.0lf"
,nDwg, rb->resval.rreal);
rb = rb->rbnext;
}
}
else {
acutPrintf(
"\nThere are no attached drawings in this project.");
}
acutRelRb(pAttachedDwgsRb);