Inserts one or more user-specified pages into the current image file.
Image Admin control
object.Insert Source, SourcePage, DestinationPage, NumPages [,CompressionType, CompressionInfo]
Parameter | Data Type | Description |
Source | String | Specifies the image file that contains the page(s) to be inserted. |
SourcePage | Long | Specifies which page in the source image file will be inserted. |
DestinationPage | Long | Specifies the page in the current image file the selected pages will be inserted before. |
NumPages | Long | Specifies the number of pages from the source image file to insert into the current image file. |
CompressionType | Integer | (Optional) Specifies the compression type to apply to the inserted pages. If a type is not specified, the compression type of the source image is used. |
CompressionInfo | Long | (Optional) Specifies which compression options to apply to the inserted pages. If options are not specified, the compression options of the source image are used. |
The current image is specified by the Image property.
The current image must be in either AWD or TIFF format, because these formats support multiple pages. If the image pages added are of another type, they will be converted to the file type used by the current image.
You can insert a single BMP page into a new image.
If the CompressionType and CompressionInfo values specified are not compatible with a source page's page type, the source file's compression type and compression information is used in place of the arguments.
If JPEG compression is specified, and the compression argument is 0 (zero), a default JPEG value is used. The default value is 4096 (low compression, high quality).
If the destination file is in AWD format, only black and white files without annotations may be appended.
The only allowable compression type for AWD is None, with no options.
Compression topics in Imaging Concepts
CompressionInfo property
CompressionType property