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




imagXpress
An imagXpress workspace instance.
srcFileName
A string which represents the TIFF or EXIF file containing a page to be inserted into the TIFF file.
dstFileName
The destination TIFF or EXIF file, which includes the inserted page.
pageNumber
The position in the destination file at which the page is added.

This is a one-based index.

Note: 0 is treated the same as a 1. The maximum page number supported is 65535.

Glossary Item Box

Inserts a new page into a multi-page document.

Syntax

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

Parameters

imagXpress
An imagXpress workspace instance.
srcFileName
A string which represents the TIFF or EXIF file containing a page to be inserted into the TIFF file.
dstFileName
The destination TIFF or EXIF file, which includes the inserted page.
pageNumber
The position in the destination file at which the page is added.

This is a one-based index.

Note: 0 is treated the same as a 1. 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 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 page number less than 0 will cause an "Invalid page number or number of pages" ImageXException to be thrown.
  • 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 appended to the end of the destination image file.
  • If the application wishes to always append the source image to the destination file then the value of System.Int32.MaxValue can be used safely for the page number.

Note: Available in Professional edition.

See Also

©2013. Accusoft Corporation. All Rights Reserved.