This documentation is for the old version. Go to the latest Upload Suite docs

ImageUploader.UploadThumbnailActualCount Property

Supported in: ActiveX , Java

Actual number of thumbnails which will be sent to the server.

Syntax

Get/Set Value in Runtime

JavaScript
value = getImageUploader("ImageUploaderID").getUploadThumbnailActualCount();

Property Value

A non-negative integer value that returns actual number of thumbnails which will be sent to the server (i.e. upload thumbnails with fit mode equal to Off are excluded).

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 one-based.

Keep in mind that number of elements in the list of upload thumbnails may be different than a number of thumbnails Image Uploader will generate and send to the server. If the fit mode of some thumbnail is set to Off, it will not be generated and sent.

This is a reason why there are two properties that return count of upload thumbnails. The UploadThumbnailActualCount property will return a number of thumbnails per one item which will be actually sent (i.e. all thumbnails with fit mode which are equal to Off are excluded). Contrary, the UploadThumbnailCount property returns total number of elements of the upload thumbnail settings list.

See Also

Reference