ImportLayer

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

The ImportLayer transaction places the specified file as a layer on the specified page. Multipage and multilayer page files cannot be selected.

Type XTYP_EXECUTE or XTYP_REQUEST

Syntax [ImportLayer(docwinID, "fileName", "layerLabel", layerType, <pageID>, <location>)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific. See Remarks.

fileName

string

file name including path of the layer file to import

layerLabel

string

label, maximum 80 characters. See Remarks.

layerType

WORD

0

placeholder

pageID

DWORD

0 | pageID

current | specific. Optional parameter.

location

WORD

0

file on disk. Optional parameter.

Reply

Data type

Meaning

layerID

DWORD

identifier of the imported layer. See Remarks.

Remarks

The specific docwinID is ignored if a specific pageID is used. If the specified page is not loaded into Imagenation, a warning message is returned.

The label string replaces the label previously assigned to this layer.

Replies are only returned when this transaction is called as an XTYP_REQUEST.

Release information

Added in Release 3.40.

See also

Adding layers and pages

Defining window titles