InsertPages Method

Description

Inserts one or more new pages into a multi-page document.

Syntax

Visual Basic
Public Sub InsertPages( _ ByVal sourceFile As String, _ ByVal sourcePageNbr As Long, _ ByVal NumPages As Long, _ ByVal destFile As String, _ ByVal destPageNbr As Long _ )

Parameters

sourceFile

A String which represents the file containing the pages to be inserted into the file.

sourcePageNbr

The position in the source file from where the source pages start.
This is a one-based index.

Note: 0 is treated the same as a 1. Valid values are from 0 to 65535.

NumPages

The number of pages from the source file that will be inserted. Valid values are from 1 to 65535.

destFile

A String which represents the file where the pages are to be inserted.

destPageNbr

The position in the destination file at which the pages are inserted.
This is a one-based index.

Note: 0 is treated the same as a 1. The maximum destination 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.
If the destination file is read-only or in-use then an IX_Error_FileOpen error will be returned.
A source or destination page number less than 0 will cause an IX_Error_InvalidPage error to be returned.
A source page number greater than 65535 will cause an IX_Error_InvalidPage error to be returned.
If the number of pages is less than 1 or greater than 65535 then an IX_Error_InvalidPage error will be returned.
If the source page number plus the number of pages exceeds the number of pages in the source file an IX_Error_InvalidPage error will be returned.
A destination page number greater than 65535 will be treated as the maximum value of 65535.
A destination page number greater than the number of pages in the destination file will result in the page being appended to the end of the destination image file.
If the application wishes to always append the source pages to the destination file then the value of int.MaxValue can be used safely for the destination page number.

Note: Available in Professional edition.