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

ImageUploader.AllowMultipleSelection Property

Supported in: ActiveX , Java

Switch that specifies whether the user is allowed to select multiple files at one time.

Syntax

Initialize

JavaScript
<script type="text/javascript" src="iuembed.js">  </script>
<script type="text/javascript">
var iu = new ImageUploaderWriter("ImageUploaderID", 610, 500);
//...other params...
iu.addParam("AllowMultipleSelection", "true");
//...other params...
iu.writeHtml();
</script>

Get/Set Value in Runtime

JavaScript
getImageUploader("ImageUploaderID").setAllowMultipleSelection(value);
value = getImageUploader("ImageUploaderID").getAllowMultipleSelection();

Property Value

A boolean value (true or false). If true, the user can select multiple files at one time (in TwoPanes layout checkboxes are displayed on the items). Otherwise, the user can select only a single file (in the TwoPanes layout radio buttons are displayed). It is demonstrated in the figure below:

AllowMultipleSelection = true

AllowMultipleSelection = true

AllowMultipleSelection = false

AllowMultipleSelection = false

Default value is "true".

Remarks

The difference between

JavaScript
<script type="text/javascript" src="iuembed.js">  </script>
<script type="text/javascript">
var iu = new ImageUploaderWriter("ImageUploader", 710, 500);

//...Any other params...

iu.addParam("AllowMultipleSelection", "true");
iu.addParam("MaxFileCount", "1");

//...

iu.writeHtml();
</script>

and

JavaScript
<script type="text/javascript" src="iuembed.js">  </script>
<script type="text/javascript">
var iu = new ImageUploaderWriter("ImageUploader", 710, 500);

//...Any other params...

iu.addParam("AllowMultipleSelection", "false");
iu.addParam("MaxFileCount", "1");

//...

iu.writeHtml();
</script>

is that when the user selects more than one image, in the first case an error message will be displayed (which states that the number of selected files exceeds the maximum files count), but in the second case a selection will be cleared from the previous file and set on the new file.

See Also

Reference