NewLayer

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

The NewLayer transaction adds a new edit layer of the specified type to a document window. If the page to which the new layer is added has not been viewed, the new layer will not be active. Otherwise it will be.

Type XTYP_EXECUTE or XTYP_REQUEST

Syntax [NewLayer(docwinID, layerType, <pageID>)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific. See Remarks.

layerType

WORD

1

Redline

 

 

2

Edit

 

 

3

Full Edit (unrestricted layer--the only type available in the standard user interface)

 

 

4

Annotation

 

 

5

Hotspot

pageID

DWORD

0 | pageID

current | specific. Optional parameter.

Reply

Data type

Meaning

layerID

DWORD

identifier of the new layer. See Remarks.

Remarks

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

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

image\postits.gif Choosing an edit layer type

Release information

Added in Release 3.40.

See also

Adding layers and pages