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 |
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