Accusoft.ImagXpress12.Net
InsertPages Method
See Also  Send Feedback
Accusoft.ImagXpressSdk Namespace > ImageX Class : InsertPages Method




imagXpress
An imagXpress workspace instance.
sourceFileName
A string which represents the TIFF or EXIF file containing the pages to be inserted into the TIFF/EXIF file.
sourcePageNumber
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.

numberOfPages
The number of pages from the source file that will be inserted. Valid values are from 1 to 65535
destinationFileName
A string which represents the TIFF or EXIF file where the pages are to be inserted.
destinationPageNumber
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.

Glossary Item Box

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

Syntax

 
Visual Basic
C#
Managed Extensions for C++
C++/CLI
 
 

Parameters

imagXpress
An imagXpress workspace instance.
sourceFileName
A string which represents the TIFF or EXIF file containing the pages to be inserted into the TIFF/EXIF file.
sourcePageNumber
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.

numberOfPages
The number of pages from the source file that will be inserted. Valid values are from 1 to 65535
destinationFileName
A string which represents the TIFF or EXIF file where the pages are to be inserted.
destinationPageNumber
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 a "File format unsupported" ImageXException will be thrown.
  • If the destination file is read-only or in-use then an "Error opening the file" ImageXException will be thrown.
  • A source or destination page number less than 0 will cause an "Invalid page number or number of pages" ImageXException to be thrown.
  • A source page number greater than 65535 will cause an "Invalid page number or number of pages" ImageXException to be thrown.
  • If the number of pages is less than 1 or greater than 65535 then an "Invalid page number or number of pages" ImageXException will be thrown.
  • If the source page number plus the number of pages exceeds the number of pages in the source file an "Invalid page number or number of pages" ImageXException will be thrown.
  • 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 System.Int32.MaxValue can be used safely for the destination page number.

Note: Available in Professional edition.

See Also

©2013. Accusoft Corporation. All Rights Reserved.