Returns a list of valid viewport layers in a specified layout blocks.
int
map_pltblkvps(
char *name,
struct struct resbuf **res);
Returns RTNORM if the list is initialized or RTERROR if the block name or layout block is invalid.
| name | Layout block name. |
| res | Pointer to pointer to result buffer of viewport layers. |
If the function returns RTNORM, you must release the resbuf.
The following sample populates a resbuf with plot layout block viewport layer name(s) using map_pltBlkVps(). If the operation is successful the viewport layer name(s) are displayed, and the resbuf is released as required.
char* pszLayoutBlockName = "TITLE-A";
struct resbuf* pLayoutBlockVportLayerRb = NULL;
int returnCode = map_pltBlkVps(pszLayoutBlockName, &pLayoutBlockVportLayerRb;);
if (RTNORM == returnCode){
struct resbuf* rb = pLayoutBlockVportLayerRb;
while(NULL != rb) {
acutPrintf(
"\nThe following viewport layer(s) have been found on the layout block \"%s\": %s"
, pszLayoutBlockName, rb->resval.rstring);
rb = rb->rbnext;
}
}
else {
acutPrintf(
"\nNo viewport layers have been found on the layout block \"%s\". ");
}
acutRelRb(pLayoutBlockVportLayerRb);