FileDownloader.DefaultDestinationFolder Property

Supported browsers: Internet Explorer

The folder which will be chosen in the Browse for folder dialog by default.

Syntax

Initialize

JavaScript

<script type="text/javascript" src="iuembed.js">  </script>
<script type="text/javascript">
var fd = new FileDownloaderWriter("FileDownloaderID", 610, 500);
//...other params...
fd.addParam("DefaultDestinationFolder", "MyComputer");
//...other params...
fd.writeHtml();
</script>

Get/Set Value in Runtime

JavaScript

getFileDownloader("FileDownloaderID").setDefaultDestinationFolder(value);
value = getFileDownloader("FileDownloaderID").getDefaultDestinationFolder();

Property Value

A path to the destination folder or a member of the following enumeration which specifies a special folder to download files by default to:

String value	Description
BitBucket	Recycle Bin
Desktop	Desktop (for the user currently logged into the system)
MyComputer	My Computer
MyDocuments	My Documents (for the user currently logged into the system)
MyMusic	My Music (for the user currently logged into the system)
MyPictures	My Pictures (for the user currently logged into the system)
MyVideo	My Video (for the user currently logged into the system)
Network	My Network Places
Recent	Recent Documents (for the user currently logged into the system)

Default value is "MyComputer".

Remarks

This property specifies the folder which will be chosen in the Browse for folder dialog by default. It may be useful if you want to provide your users with possibility to download music files to MyMusic folder, image files to MyPictures, and etc.

Note

File Downloader behaves differently about this property in Internet Explorer and other browsers.

Being loaded in Internet Explorer File Downloader takes the value of the DefaultDestinationFolder property into account in the first launch after installation only. If a user has downloaded files to another folder, this folder will be chosen in the Browse for folder dialog in the next launch of File Downloader.

In non-Internet Explorer browsers only Desktop and My Documents folders are supported by the DefaultDestinationFolder property. Also the default folder will be chosen each time the Browse for folder dialog has been opened.