NewPage

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

The NewPage transaction adds a new, blank page to the specified document window. The first time this transaction is used after a CreateDocwin transaction, the existing blank page is replaced by the new blank page.

Type XTYP_EXECUTE or XTYP_REQUEST

Syntax [NewPage(docwinID, pageNum, relPosition, parentID, pageType, "pageLabel")]

 [NewPage(documentID, pageNum, relPosition, parentID, pageType, "pageLabel")]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific

or

 

 

 

documentID

DWORD

documentID

identifier of the document

pageNum

WORD

1 | 2 | . . . | last page number

page number relative to which the new page is added

relPosition

WORD

0

before pageNum

 

 

1

after pageNum

 

 

2

start of parentID document

 

 

3

end of parentID document

parentID

DWORD

0

same parent as pageNum

 

 

pageID

embedded into specific page. See Remarks.

pageType

WORD

0

page with layers

 

 

1

multipage root

pageLabel

string

label, maximum 80 characters

Reply

Data type

Meaning

newPageID

DWORD

identifier of the new page. See Remarks.

Remarks

The page node identified by parentID must be an ancestor of the page identified by pageNum.

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

Release Information

Added in Release 3.70.

See also

Adding layers and pages

Defining window titles