map_pltblkatts

Gets a list of block attributes.

int

map_pltblkatts(

char *name,

struct resbuf **res);

Returns RTNORM or RTERROR.

name	Layout block name.
res	Pointer to pointer to result buffer of block attributes.

If the function returns RTNORM, you must release the resbuf.

The following sample populates a resbuf with plot layout block attribute name(s) using map_pltBlkAtts(). If the operation is successful the attribute name(s) are displayed, and the resbuf is released as required.

char* pszLayoutBlockName = "TITLE-A";
struct resbuf* pLayoutBlockAttsRb = NULL;
int returnCode = map_pltBlkAtts(pszLayoutBlockName, &pLayoutBlockAttsRb;);
if (RTNORM == returnCode){
    struct resbuf* rb = pLayoutBlockAttsRb;
    while(NULL != rb) {
        acutPrintf(
            "\nThe following block attribute has been found on the layout block \"%s\": %s"
            , pszLayoutBlockName, rb->resval.rstring);
        rb = rb->rbnext;
    }
}
else {
    acutPrintf(
        "\nNo block attributes have been found on the layout block \"%s\". ");
}
acutRelRb(pLayoutBlockAttsRb);