Insert Method

Example-VB Example-VC++

Inserts one or more user-specified pages into the current image file.

Available With

Ö Imaging for Windows Professional Edition V1.0, V1.1, and V2.0
Ö Imaging for Windows 95 and 98
Ö Imaging for Windows NT 4.0

Applies To

Image Admin control

Syntax

object.Insert Source,SourcePage,DestinationPage,NumPages [,CompressionType,CompressionInfo]

Arguments

Parameter Data Type Description

Source String Specifies the image file that contains the page(s) to be inserted. The file can reside on a

local or redirected drive (desktop)

1.x server

3.x server

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.

Remarks

The current image is specified by the Image property. If an image does not exist, one is created, and the destination page will be 1.

The current image must be a TIFF, AWD, or 1.x server document, because they 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 is a 1.x document, and the source page does not reside in the 1.x repository, the FileStgLoc1x property must be set.

For other operations with 1.x documents, the ForceFileLinking1x property can be used.