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.