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);