Fit mode of the specified upload thumbnail.

Syntax

Get/Set Value in Runtime
JavaScript CopyCode imageCopy 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.

NoteNote

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.

NoteNote

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.

See Also

Examples
Resizing and Rotating Images

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