Aurigma Image Uploader 6.0 Dual
ImageUploader.DropFilesHereImageFormat Property
See Also Supported in: ActiveX Java

Image displayed on the upload pane when no files are selected for the upload.

# Syntax

##### Initialize

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

##### Get/Set Value in Runtime

JavaScript | Copy Code
--- | ---
    getImageUploader("ImageUploaderID").setDropFilesHereImageFormat(value);
    value = getImageUploader("ImageUploaderID").getDropFilesHereImageFormat();

##### Property Value

A string value that specifies settings of the image displayed on the upload pane when no files are selected for the upload. See the Remarks section for more details about syntax of this string. If an empty string is specified, standard Drop Files Here label is displayed.

Default value is "".

# Remarks

The string which specifies settings of the image displayed on the upload pane has the following syntax:

`variable1=value1;variable2=value2;...`

The following variables are supported:

Variable | Description
--- | ---
Url | URL to the image that will be displayed on the upload pane when no files are selected for the upload. Mandatory.
Width | Width of the image that will be displayed on the upload pane when no files are selected for the upload. Mandatory. The image will be resized to the specified dimensions without keeping aspect ratio.
Height | Height of the image that will be displayed on the upload pane when no files are selected for the upload. Mandatory. The image will be resized to the specified dimensions without keeping aspect ratio.
Position | Image position. Optional. It can take one of the following values: TopLeft - image will be displayed in the top left corner of the upload pane. TopCenter - image will be displayed in the center of the top of the upload pane. TopRight - image will be displayed in the right top corner of the upload pane. CenterLeft - image will be displayed in the center of the left edge of the upload pane. Center - image will be displayed in the center of the upload pane. CenterRight - image will be displayed in the center of the right edge of the upload pane. BottomLeft - image will be displayed in the bottom left corner of the upload pane. BottomCenter - image will be displayed in the center of the bottom of the upload pane. BottomRight - image will be displayed in the bottom right corner of the upload pane. Default value is `Center`.

Note
The image format string is case insensitive.

You can use images of the all formats which are recognized by Image Uploader as images. If you load animated GIF files, only the first frame will be displayed.

You should obligatory specify width and height of the image. Otherwise standard Drop Files Here label will be displayed.

Image URL can be both absolute (e.g. `Url=http://domain.com/images/button1.gif`) and relative to the current page (e.g. `Url=../images/button1.gif`).

This property can be used with `OnePane` and `ThreePanes` layout. For more infomation read Layouts article.

# See Also

##### Examples

Customizing Appearance

##### Reference

DropFilesHereText Property