InsertPage Method

The 1-indexed page number before which the new page should be inserted.

Note that the value of this argument will not cause any sort of validation error. The following rules apply:

A value of 0 will be treated the same as a value of 1 (that is, the page will be inserted at the beginning of the document).
A negative value will cause the page to be inserted at the end of the document.
A positive value greater than the number of pages will also cause the page to be inserted at the end of the document.
The maximum page number supported is 65535.

Description

Inserts a new page into a multi-page document.

Syntax

Visual Basic
Public Sub InsertPage( _ ByVal sourceFile As String, _ ByVal destFile As String, _ ByVal PageNbr As Long _ )

Parameters

sourceFile

A string which represents the TIFF or EXIF file containing a page to be inserted into the TIFF file.

destFile

The name of the destination file, which will include the inserted page.

PageNbr

The 1-indexed page number before which the new page should be inserted.

Note that the value of this argument will not cause any sort of validation error. The following rules apply:

A value of 0 will be treated the same as a value of 1 (that is, the page will be inserted at the beginning of the document).
A negative value will cause the page to be inserted at the end of the document.
A positive value greater than the number of pages will also cause the page to be inserted at the end of the document.
The maximum page number supported is 65535.

Remarks

This method is for TIFF and EXIF file formats.

If an invalid format is specified for the source or destination files then an IX_Error_InvalidFormat error will be returned.
A page number less than 0 will cause an IX_Error_InvalidPage error to be returned.
A page number greater than 65535 will be treated as the maximum value of 65535.
A page number greater than the number of pages in the destination file will result in the page being added to the end of the destination image file.
If the destination file is read-only or in-use then an IX_Error_FileOpen error will be returned.
This method does not work for some particular TIFF types, like IX_ImageType_Tiff_Jpeg and IX_ImageType_Tiff_Lzw.

Note: Available in Professional edition.