SaveAs Method

Example-VB

Enables the programmer to control when thumbnail representations of the pages in the specified object (local/redirected drive, 1.x, or 3.x) are saved to a specified file format.

Available With

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

Applies To

Image Thumbnail control

Syntax

object.SaveAs(Filename,SaveOptions,FirstThumb,LastThumb)

Arguments

Parameter Data Type Description

Filename String Specifies the name of the file that will receive the saved thumbnails
SaveOptions Integer Optional. Specifies the format of the file that will receive the saved thumbnails. If no format is specified, TIFF will be used. Valid values are:

1 Contact Sheet image in multipage TIFF format. Thumbnails will be organized by using the current size, on multiple pages based on the range of thumbnails.

2 Contact Sheet image in BMP format with a single page of thumbnails

3 TIFF file with 1 thumbnail per page

4 BMP file with 1 thumbnail

Additive options are:

+256 Compressed TIFF contact sheets using LZW compression

+512 “Burn in” thumbnail image stamps, backgrounds, and captions into the TIFF contact sheets

+1024 Generate thumbnail images with annotations displayed

+2048 Create hyperlinks between the thumbnail image stamp annotations on the contact sheet and the source file. This option cannot be ORed with the value of +512 (“burn in” annotations).

+4096 Save the currently selected thumbnails. The current image file must be the source image file for the call to the SaveAs method

These additive options can be ORed with the main options 1, 2, 3, or 4  as follows:

0x0100 LZW compression (options 1 and 3 only)

0x0200 Burn in annotations

0x0400 Generate thumbnails including annotations

0x0800 Hyperlink image stamps to original image (options 1 and 3 only)

0x1000 Save only sthe selected thumbs

FirstThumb Long Optional. Indicates the one (1) relative thumbnail that corresponds to the page of the thumbnail to be generated and saved. (1 relative means the first page that is specified by passing FirstThumb=1). The default value for this parameter is 1.
LastThumb Optional. Indicates the one (1) relative thumbnail that corresponds to the page of the thumbnail to be generated and saved.

If this parameter is not specified, the default value of ThumbCount is used for TIFF output, and FirstThumb for BMP output.


Remarks

Use the SetSaveAsDimensions method to generate thumbnails of a different size.

In all cases, the aspect ratio of the thumbnail is kept, and the generated thumbnails are centered within the specified dimensions.

If you are saving to a 1.x document, you must include the Admin control in the project and set the FileStgLoc1x. The Admin ForceFileLinking1x property can be used if required, for 1.x document operations.