IN_NewPage

image\bltlrgsq_shg.gif Editions  image\bltlrgsq_shg.gif Related Functions  image\bltlrgsq_shg.gif Example

The IN_NewPage function adds a new, blank page in the specified position to the specified document window.

Syntax

int IN_NewPage( docwinID, pageNumber, relPosition, parentID, pageType, pPageID )

Input Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific

SHORT pageNumber

1, 2, . . . last page

page number relative to which the new page is added

SHORT relPosition

IN_NEWPAGE_*

BEFORE (0) before pageNumber

AFTER (1) after pageNumber

BEGIN (2) insert the page at the beginning

END (3) insert the page at the end

(If you place the page at the beginning or end, you must supply the parentID.)

IN_OBJECT parentID

0 same parent as pageNumber

pageID embedded into this page. See Remarks.

SHORT pageType

0 page with layers

multipage root

Output Parameters

Values

Meaning

IN_PAGE_PTR pPageID

0 | pageID

pointer to the new page identifier

Remarks

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

The first time you call IN_NewPage after calling IN_CreateDocumentWindow, the existing blank page in the new document window is replaced by the newly created page.

Release information

Added to Imagenation for Windows in Release 4.10.

As of Release 5.1, also available in Imagenation for UNIX.

Also supported in Imagenation 3.3 for UNIX.

See also

Adding layers and pages