map_pltdeflist

Land Desktop Development ARX CPP SDK

Up a level
map_pltdeflist
 
 

Gets the names of available plot set definitions.

int

map_pltdeflist(

struct resbuf **res);

Returns RTNORM or RTERROR.

res Pointer to pointer to resbuf for list of returned plot set definitions.

This function returns the value of the attribute through the resbuf parameter. If the function returns RTNORM, you must release the resbuf.

The following sample populates a resbuf with the plot set names using map_pltDefList(). If the operation is successful the plot set name(s) are displayed, and the resbuf is released as required.

struct resbuf* pPlotSetListRb = NULL;
int returnCode = map_pltDefList(&pPlotSetListRb;);
if (RTNORM == returnCode){
    struct resbuf* rb = pPlotSetListRb;
    acutPrintf(
        "\nThe current project contains the following plot set(s): ");
    while(NULL != rb) {
        acutPrintf(
           "\n\"%s\"", rb->resval.rstring);
        rb = rb->rbnext;
    }
}
else {
    acutPrintf(
        "\nThe current project contains no plot sets.");
}
acutRelRb(pPlotSetListRb)