Replace Method

Example-VB Example-VC++

Replaces one or more user-specified pages in a file specified by the Image property.

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.Replace 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 the first page in the source image file that will be inserted
DestinationPage Long Specifies the first page in the current image file that will be replaced
NumPages Long Specifies the number of pages in the current image file to replace with pages from the source image file
CompressionType Integer (Optional)  Specifies the compression type to apply to the replaced 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 replaced pages. If options are not specified, the compression options of the source page are used.

Remarks

The current image is specified by the Image property.

The replaced pages are converted to the file type of the current image (TIFF, AWD, or BMP).

If you are replacing the single page in a BMP file, the only compression type allowed is None, with no options.

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.