Aurigma Image Uploader 4.8 Dual
ImageUploader.UploadThumbnailFitMode Property
See Also Supported in: ActiveX Java

Fit mode of the specified upload thumbnail.

# Syntax

##### Get/Set Value in Runtime

JavaScript | Copy Code
--- | ---
    getImageUploader("ImageUploaderID").setUploadThumbnailFitMode(Index, value);
    value = getImageUploader("ImageUploaderID").getUploadThumbnailFitMode(Index);

##### Parameters

Index

  A non-negative integer that specifies an index of the upload thumbnail (one-based). It should not exceed `UploadThumbnailCount - 1` . If extra upload thumbnails are required, use the UploadThumbnailAdd method to add them.

##### Property Value

A member of this enumeration that specifies a fit mode for the specified thumbnail:

String value | Integer value | Description
--- | --- | ---
Off | 0 | Do not send a thumbnail of this size to the server.
Fit | 1 | Send a thumbnail which is resized to fit the specified rectangle.
Width | 2 | Send a thumbnail which is resized to have the width which is not larger than the specified one.
Height | 3 | Send a thumbnail which is resized to have the height which is not larger than the specified one.
Icon | 4 | Send an icon of the file instead of the thumbnail.
ActualSize | 5 | Send the image of the original size (rotating and recompressing it if necessary).

If unsupported string value is passed, it is interpreted as `Off`.

Note
When you receive this value through the JavaScript, integer value will be returned (even if you initialize appropriate property with a string value).

# Remarks

Image Uploader can generate multiple thumbnails per one file sent to the server. To configure sizes of thumbnails and other parameters, you can manipulate a list of upload thumbnail settings. It can be done two ways:

1. Use `UploadThumbnailNXXX` parameters, where N is a number in range from 1 to 3.
2. Use the UploadThumbnailAdd method in JavaScript to add extra thumbnail sizes, and `UploadThumbnailXXX` properties to change specific settings.

First method is simpler, however it allows to upload not more than 3 thumbnails per one file. The second one does not have any limitation on the number of thumbnails.

To get an upload thumbnail on the server use the `UploadThumbnailX` HTTP POST field, where X is an index of the upload thumbnail.

Note
The index of upload thumbnail list is zero-based. However by default upload thumbnail with zero index is disabled (its fit mode is `Off`).

If you choose to send resized thumbnails, you can specify the quality of resizing with the UploadThumbnailResizeQuality property. You can also use the UploadThumbnailFallbackMode property to define what to do when a thumbnail cannot be created.

# See Also

##### Examples

Resizing and Rotating Images

##### Reference

UploadThumbnailAdd Method
UploadThumbnailBackgroundColor Property
UploadThumbnailCompressOversizedOnly Property
UploadThumbnailCopyExif Property
UploadThumbnailCopyIptc Property
UploadThumbnailFallbackMode Property
UploadThumbnailHeight Property
UploadThumbnailJpegQuality Property
UploadThumbnailResizeQuality Property
UploadThumbnailWatermark Property
UploadThumbnailWidth Property