GetVisibleLayerMER

All Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The GetVisibleLayerMER transaction returns the extents (minimum enclosing rectangle--MER) for the specified layer. This can be useful for determining if the layer size is within the limits of the printer being used. CAD layers cannot be queried.

Type  XTYP_REQUEST

Syntax [GetVisibleLayerMER(docwinID, layerID, units, <pageID>)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific

layerID

DWORD

identifier of the layer to get the extents of

units

WORD

units to return the coordinates in:

 

 

1

inches

 

 

2

cm

 

 

4

feet

 

 

5

mm

 

 

6

m

 

 

9 | 10 | 11

custom 1 | 2 | 3. See Remarks.

pageID

DWORD

0 | pageID

current | specific. Optional parameter.

Reply

Data type

Meaning

x1, y1

float

top-left coordinates of the extents

x2, y2

float

bottom-right coordinates of the extents. See Remarks.

Remarks

To be used, custom units must be defined in Imagenation (through the Units category or dialog box).

If the specified layer is hidden, the coordinates returned will be 0, 0, 0, 0.

image\tips.gif Parameter tip

Release information

Added in Release 5.10.

See also

Getting page and layer extents