Version 1.3.0.0 or later

Explanation

Starts the compress-download.

If you set the server path to compress the file using the setCompressURL method, the virtual files to be downloaded are compressed into a single file and downloaded.

Unlike single/multiple-file(s)-download, compresse-download is not affected by the properties (downUrl or url) that specify the download path to the target file, because they direct the compression process to the server.

var dx = dx5.get("component-id");

// You must specify the value of the vindex property to distinguish the compression target on the server that needs compression.
// vindex is a unique string value, which is the only way to distinguish between virtual files. 
dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147 });
dx.addVirtualFile({ vindex: "IDX0004", name: "beach_239826.jpg", size: 239826 });
dx.addVirtualFile({ vindex: "IDX0005", name: "cosmos (empty) 195779.jpg", size: 195779 });

// Set the address to process the compression and return the compressed file download path
dx.setCompressURL("http://domain/path/service/compress.do");

// Perform to download according to the flag value.
// AUTO: Download compressed virtual files.
// SELECTED: Download compressed selected virtual files.
// CHECKED: Download compressed checked virtual files. 
dx.downloadCompressed("SELECTED");

You can use the btnDownloadCompressedAuto property value at the time of component creation to use it automatically.

<button id="btn-download-compressing" type="button">Compress & Download</button>
<script>
  dx5.create({
    ...,
    //The compress-download function is automatically binded.
    btnDownloadCompressedAuto: "btn-download-compressing"
  });
</script>

In addition to the btnDownloadCompressedAuto property, you can use btnDownloadCompressedChecked, btnDownloadCompressedSelected.

When the downloadCompressed method is called, the DEXTUploadX5 module creates a list string of comma-separated list of vindex values ​​of items to be compressed, and submits the list string to the form data named "DEXTUploadX5_VIndexes" in POST format.

When a request is made to the server path, the server web application must compress files and return the server address where the target file can be downloaded.

While the compression is running on the server, a progress window is displayed, but when the compressed file is downloaded, it is converted to a single-file-download.

Uses

component.downloadCompressed(flag);

Parameters

Version 1.3.0.0 or later

Explanation

Returns the server address that handles file compression.

Uses

url = component.getCompressURL();

Return

Path to handle file compression

Version 1.3.0.0 or later

Explanation

Sets the server address to handle file compression.

var dx = dx5.get("component-id");

// You must specify the value of the vindex property to distinguish targets on the server.
// vindex is a unique string value, which is the only way to distinguish between virtual files.
dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147 });
dx.addVirtualFile({ vindex: "IDX0004", name: "beach_239826.jpg", size: 239826 });
dx.addVirtualFile({ vindex: "IDX0005", name: "cosmos (empty) 195779.jpg", size: 195779 });

// Set the address to process the compression and return the compressed file download path. 
dx.setCompressURL("http://domain/path./service/compress.do");

// Perform to download according to the flag value.
// AUTO: Download compressed virtual files.
// SELECTED: Download compressed selected virtual files.
// CHECKED: Download compressed checked virtual files. 
dx.downloadCompressed("SELECTED");

When a request is made to the server path, the server web application must compress the file and return the server address where the target file can be downloaded.

Uses

component.setCompressURL(url);

Parameters

Version 1.3.0.0 or later

Explanation

Sends a request to stop the file compression.

DEXTUploadX5 does not have a button or GUI element that stops the compression request on the component itself.

Instead, it provides a function that can be stopped using a script.

<button type="button" onclick="stop('component-id');">중지</button>
<script>
function stop(id) {
  dx5.get(id).stopCompressWaiting();
}
</script>

You can use the btnStopCompressWaiting property value at the time of component creation to bind automatically.

<button id="btn-stop-compresswaiting" type="button">Stop</button>
<script>
  dx5.create({
    ...,
    // The stop request function is automatically binded.
    btnStopCompressWaiting: "btn-stop-compresswaiting"
  });
</script>

The stopCompressWaiting method stops the compression request. After the compression process is completed, the process of downloading the file is not canceled.

Uses

component.stopCompressWaiting();

Version 1.1.0.0 or later

Explanation

Sets the individual size limit for downloaded files. Due to browser memory management issues, a size limit has been imposed on downloaded files.

The default value is 100MB. To allow file sizes larger than this, you must change the limit using the setLimitMultiDownloadSize method.

// Set the download limit to 300MB. 
dx.setLimitMultiDownloadSize(1024 * 1024 * 300);

• This function changes the size of files allowed for download; it does not improve browser memory performance. If a file is extremely large, it may cause the browser to crash, depending on the browser.
• Starting from version 4.0.0.0, this also applies to single-file-download.

Uses

component.setLimitMultiDownloadSize(limit);

Parameters

Version 3.8.0.0 or later

Explanation

Enable or disable continuation when downloading multiple files. If you are interrupted while downloading a file, the download resumes from the point where you left off. However, unlike pickup from uploads, this happens after you cancel the download or close the window, resume downloading, the download will start from the beginning.

The default is true. If your server does not accept Range requests, it is recommended to set this to false.

function onDX5Created(id) {
    var dx = dx5.get(id);
    // Disable the resume downloading.
    dx.enableResumingDownload(false);
}

As of version 3.8.0.0, the resume downloading feature is implemented to force a HEAD request to be sent to the server. Even though you disable the resuming feature, the HEAD request will still occur.

Uses

component.enableResumingDownload(enable);

Parameters

Version 3.8.0.0 or later

Explanation

Pause a multiple file download operation.

<button type="button" onclick="pause('component-id');">Pause</button>
<script>
function pause(id) {
    dx5.get(id).pauseDownloading();
}
</script>

Only multiple file download operations can be paused using functions. If you are downloading a target using downloadById or the download icon, using the pauseDownloading function will not stop the operation.

Uses

component.pauseDownloading();

Version 3.8.0.0 or later

Explanation

Resumes a paused multiple file download operation.

<button type="button" onclick="resume('component-id');">Resume</button>
<script>
function resume(id) {
    dx5.get(id).resumeDownloading();
}
</script>

You can use the pauseDownloading method only when a download operation has been paused using the pauseDownloading method, or when it has been paused due to an error.

Uses

component.resumeDownloading();

Version 3.8.0.0 or later

Explanation

Sets the download unit size for multiple file download operations.

When performing a multiple file download operation, DEXTUploadX5 divides the file by the unit size to download the file. Setting a larger download unit size reduces the number of download iterations and vice versa increases the number of download iterations. When taking over a file, the smaller the unit size, the less data is lost when the download operation is stopped.

// Limit the size of the file to be downloaded to 500 MB.
dx.setLimitMultiDownloadSize(1024 * 1024 * 500);

// Set the download unit size to 10 MB.
dx.setDownloadBlockSize(1024 * 1024 * 10);

// Start a multiple file download.
dx.download("AUTO", true);

• A good download unit size is 10MB, which is currently set as the default.
• Smaller unit sizes can cause memory overhead, and are only recommended on slow networks.
• The server must allow HEAD requests.
• If your server doesn't allow Range requests, you'll receive the file all at once without splitting it up.

Uses

component.setDownloadBlockSize(size);

Parameters

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Returns whether the HD application is used for single-file-download.

Uses

using = component.isUsingHDWhenSingle();

Return

true, false

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Enable or disable the HD application for single-file-download.

Only a single-file-download is executed when the download icon is clicked on the GUI. If you use the downloadById method, the browser-based download is performed regardless of the setting.

// Use the HD application. 
dx.setUsingHDWhenSingle(true);

When an item with the same name as the download target already exists, the developer can use the callback function (duplicated) to add (override) or ignore this item.

dx.setUsingHDWhenSingle(true, function (duplicated) {
    if (confirm(duplicated + " exists already. Do you want to add though?")) {
        // return 0; If you do not have a return value, add an item regardless of the duplicate.
    } else {
        // Ignore.
        return 1;
    }
});

The internal processing method according to the return value is as follows.

• 1: Do not add an item.
• 2: Add an item, which is automatically added without any callback calls for subsequent duplicate events.
• 3: Do not add an item, and duplicate events are automatically ignored without callback calls.
• Other values: Add an item.

Uses

component.setUsingHDWhenSingle(enable[, funcDuplication]);

Parameters

Version 3.10.0.0 or later

Explanation

Returns a value for the time interval between file download operations.

Uses

interval = component.getDownloadTimeInterval();

Return

The time interval value in milliseconds (1/1000)

Version 3.10.0.0 or later

Explanation

Sets the time interval value between file download operations.

A multi-file download will result in multiple download operations, depending on the number of files and the number of chunks, each of which will be delayed by the given time value.

var dx = dx5.get("component-id");
dx.setDownloadTimeInterval(1000);

Uses

component.setDownloadTimeInterval(interval);

Parameters

Version 3.10.0.0 or later

Explanation

Returns whether to send a HEAD request to the server for the download.

Uses

useHead = component.isDownloadHeadRequestEnable();

Return

true/false

Version 3.10.0.0 or later

Explanation

Sets whether to send a HEAD request for download to the server.

The product sends a HEAD request in advance to get information about the file to be downloaded. If the server does not allow HEAD requests, you should set this to false.

If you don't make HEAD requests, you can't use the Continue function, and it's difficult to check for server errors when downloading a single file.

var dx = dx5.get("component-id");
dx.setDownloadHeadRequestEnable(false);

Uses

component.setDownloadHeadRequestEnable(enable);

Parameters

Version 4.0.0.0 or later

Explanation

Gets the download method.

Uses

mode = component.getDownloadMode();

Return

Either 'DEFAULT', 'AWSS3' or 'NCPOS', 'AZRBS' is returned. The default value is 'DEFAULT'.

Version 4.0.0.0 or later

Explanation

Sets the download method.

• DEFAULT: Used when using the default supported download method.
• AWSS3: Used when downloading files from Amazon S3. Supported in 4.0.0.0 and above.
• NCPOS: Used when downloading files from NAVER CLOUD PLATFORM Object Storage. Supported in 4.2.0.0 and above.
• AZRBS: Used when downloading files from Azure Blob Storage. Supported in 4.3.0.0 and above.

const dx = dx5.get(id);
dx.setDownloadMode("AWSS3");

Uses

component.setDownloadMode(mode);

Parameters

Version 4.0.0.0 or later

Explanation

Define settings for downloading files from Amazon S3.

dx.setDownloadMode("AWSS3");
dx.setAWSS3DownloadConfig({
    type: "NON-SECRET",
    accessKeyId: "ABCD...1234",
    secretAccessKey: "ABCD...1234",
    region: "ap-northeast-2",
    bucket: "abc-bucket"
});

Uses

component.setAWSS3DownloadConfig(config);

Parameters

dx.setAWSS3DownloadConfig({
    makeKey: item => {
        return item.name;
    }
});

Version 4.2.0.0 or later

Explanation

Define settings for downloading files from NAVER CLOUD PLATFORM Object Storage

dx.setDownloadMode("NCPOS");
dx.setNCPOSDownloadConfig({
    type: "NON-SECRET",
    accessKeyId: "ABCD...1234",
    secretAccessKey: "ABCD...1234",
    // kr, us, sg, jp, de
    region: "kr",
    bucket: "abc-bucket"
});

Uses

component.setNCPOSDownloadConfig(config);

Parameters

dx.setNCPOSDownloadConfig({
    makeKey: item => {
        return item.name;
    }
});

Version 4.3.0.0 or later

Explanation

Define settings for downloading files from AZURE Blob Storage.

dx.setDownloadMode("AZRBS");
dx.setAZRBSDownloadConfig({
    sasDownloadURL: "https://example.com/get-download-sastoken.ashx"
});

Uses

component.setAZRBSDownloadConfig(config);

Parameters

dx.setAZRBSUploadConfig({
    makeKey: item => {
        return item.name;
    }
});

Version 1.0.0.0 or later

Explanation

Start downloading files.

To download a file, you need to be able to get the path information of the file that exists on the server, using a property of the virtual file.

By default, only one virtual file can be downloaded. Therefore, only the first file among the targets that match the flag will be downloaded. If you want to download multiple files (supported from 1.1.0.0), set the useMD parameter to true to handle multiple-files-download, and all files matching the flag will be downloaded sequentially.

The virtual file you want to download must have a server-side address that can be downloaded to the downUrl property. (You can also use the url property from version 1.4.1.0.)

The destination path must be set using the server's capabilities, so that the Content-Disposition response header value is in the attachment state.

For file downloads, a HEAD method request is sent to determine if the target exists, and if the HTTP response code is not an error, the download is performed again.

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // It is a virtual file that can not be downloaded because there is no download path information. 
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    //  You can download the file because it has a download path.
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, downUrl: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    // Perform to download according to the flag value.
    // AUTO: Download the first virtual file.
    // SELECTED: Download the first selected virtual file.
    // CHECKED: Download the first checked virtual file.
    dx5.get(id).download("AUTO");
  }
  function multidownload(id) {
    // Perform to download according to the flag value.
    // AUTO: Downloads all virtual files.
    // SELECTED: Downloads all selected virtual files.
    // CHECKED: Downloads all checked virtual files.
    dx5.get(id).download("AUTO", true);
  }
</script>
<button type="button" onclick="download('component-id');">Single-File-Download</button>
<button type="button" onclick="multidownload('component-id');">Multiple-Files-Download</button>

When using the download method, there is a difference from version 1.0.0.0. In the case of single-file-download, in case of 1.0.0.0 version, downUrl is not specified for the target corresponding to the flag value, but downloading is canceled. In 1.1.0.0 version, if the target corresponding to flag value is not specified for downUrl, it finds the next suitable file. Therefore, to download the exact target, we recommend using downloadById instead of download method.

The multi-file download feature added in version 1.1.0.0 is implemented purely as a browser feature without using plugin technology. Providing a progress window, like a download using a plugin, but because there is a stage where the browser finally stores the file (the product can not participate), messages that query in the browser can be displayed have. In addition, on macOS, we only support Safari browser versions 10.1 and above. And on iOS and iPad, Safari browser version 17 or later supports multi-file downloads (no more than 10 files).

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // It is a virtual file that can not be downloaded because there is no download path information. 
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    //  You can download the file because it has a download path.
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    // Perform to download according to the flag value.
    // AUTO: Downloads all virtual files.
    // SELECTED: Downloads all selectedvirtual files.
    // CHECKED: Downloads all checkedvirtual files.
    dx5.get(id).download("AUTO");
  }
</script>
<button type="button" onclick="download('component-id');">Download</button>

Uses

// Version 1.1.0.0 or later
object.download(flag[, useMD]);

Parameters

Version 1.0.0.0 or later

Explanation

Download a virtual file corresponding to a given unique ID.

To download a file, you need to be able to get the path information of the file that exists on the server, using the properties of the virtual file.

The virtual file to be downloaded must have a downloadable server-side address set in the downUrl attribute (as of version 1.4.1.0, this can also be done with the url attribute).

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // It is a virtual file that can not be downloaded because there is no download path information. 
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // You can download the file because it has a download path.
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, downUrl: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    var dx = dx5.get(id);
    // Select the second virtual file.
    var itemId = dx.getItemId(1);
    dx.downloadById(itemId);
  }
</script>
<button type="button" onclick="download('component-id');">Download</button>

The download path uses a server-side component, which must have a Content-disposition response header value of attachment.

In addition, a HEAD method request is sent to determine if the target exists, and the download is performed again if the HTTP response code is not an error.

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // It is a virtual file that can not be downloaded because there is no download path information. 
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // You can download the file because it has a download path.
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    var dx = dx5.get(id);
    // Select the second virtual file.
    var itemId = dx.getItemId(1);
    dx.downloadById(itemId);
  }
</script>
<button type="button" onclick="download('component-id');">Download</button>

Uses

component.downloadById(id);

Parameters

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Download the virtual file corresponding to the given unique ID using the HD application.

To download a file, you need to be able to get the path information of the file that exists on the server, using the properties of the virtual file.

The virtual file must have a server-side address that can be downloaded to the url property.

Starting with version 1.4.1.0, you can use two properties: downUrl and url.

<script>
    function onDX5Created(id) {
        var dx = dx5.get(id);
        // It is a virtual file that can not be downloaded because there is no download path information. 
        dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
        // You can download the file because it has a download path.
        dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001", chunkSize: 10 });
    }
    function download(id) {
        var dx = dx5.get(id);
        // Select the second virtual file.
        var itemId = dx.getItemId(1);
        dx.downloadByIdToHD(itemId);
    }
</script>
<button type="button" onclick="download('component-id');">Download</button>

When downloading using the HD application, the file can be forcibly downloaded regardless of whether the content-disposition response header of the server for the download request is attachement or inline.

When an item with the same name as the download target already exists, the developer can use the callback function (duplicated) to add (override) or ignore this item.

var dx = dx5.get(id);
// Select the second virtual file.
var itemId = dx.getItemId(1);
dx.downloadByIdToHD(itemId, function (fileName) {
    if (confirm(fileName + " exists already. Do you want to add though?")) {
        // return 0; If you do not have a return value, add an item regardless of the duplicate.
    } else {
        // Ignore.
        return 1;
    }
});

The internal processing method according to the return value is as follows.

• 1: Do not add an item.
• 2: Add an item, which is automatically added without any callback calls for subsequent duplicate events.
• 3: Do not add an item, and duplicate events are automatically ignored without callback calls.
• Other values: Add an item.

Uses

component.downloadByIdToHD(id[, duplicated]);

Parameters

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Use the HD application to start downloading multiple files.

To download a file, you need to be able to get the path information of the file that exists on the server, using the properties of the virtual file.

The virtual file you want to download must have a server-side address that can be downloaded to the url property.

Starting with version 1.4.1.0, you can use two properties: downUrl and url.

<script>
    function onDX5Created(id) {
        var dx = dx5.get(id);
        // It is a virtual file that can not be downloaded because there is no download path information. 
        dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
        // You can download the file because it has a download path.
        dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001", chunkSize: 10 });
    }
    function download(id) {
        // Perform to download according to the flag value.
        // AUTO: Download virtual files.
        // SELECTED: Download selected virtual files.
        // CHECKED: Download checked virtual files.
        dx5.get(id).downloadToHD("AUTO");
    }
</script>
<button type="button" onclick="download('component-id');">Download</button>

If you want to process uploads with the "AUTO" parameter value without special code processing, you can use the btnDownloadToHDAuto property value at the time of component creation to bind automatically.

<button id="btn-download" type="button">Download</button>
<script>
    dx5.create({
        ...,
        // The file download function is automatically binded.
        btnDownloadToHDAuto: "btn-download"
    });
</script>

In addition to the btnDownloadToHDAuto property, you can use btnDownloadToHDSelected, btnDownloadToHDChecked.

When an item with the same name as the download target already exists, the developer can use the callback function (duplicated) to add (override) or ignore this item.

var dx = dx5.get(id);
dx.downloadToHD("AUTO", function (fileName) {
    if (confirm(fileName + " exists already. Do you want to add though?")) {
        // return 0; if there is no return, add an item regardless of duplicate.
    } else {
        // Ignore.
        return 1;
    }
});

The internal processing method according to the return value is as follows.

• 1: Do not add an item.
• 2: Adds an item, which is automatically added without any callback calls for subsequent duplicate events.
• 3: Do not add an item, and duplicate events are automatically ignored without callback calls.
• Other values: Add an item.

You can not apply a callback function for duplicate processing when you bind to a button automatically.

Uses

component.downloadToHD(flag[, duplicated]);

Parameters

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Returns the download path set in the HD application.

dx.getDownloadPathOfHD(function (path) {
  console.log(path);
});

Most of the methods that will be used when using HD applications perform asynchronous operations internally. Because the task is asynchronous, the thread will not wait until the return value is received, and you must use the callback function to get the result of the request.

Uses

component.getDownloadPathOfHD(success);

Parameters

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

Set the download path.

// If you start with a drive string, the absolute path is set.
dx.setDownloadPathOfHD("c:\\temp");
// Starting with the <home> string, the subpath relative to user folder is set. 
dx.setDownloadPathOfHD("<home>\\temp");
// Starting with the <doc> string, the subpath relative to document folder is set.
dx.setDownloadPathOfHD("<doc>\\temp");
// Starting with the <desktop> string, the subpath relative to desktop folder is set.
dx.setDownloadPathOfHD("<desktop>\\temp");
// Starting with the <downloads> string, the subpath relative to download folder is set. (Supported from version 2.5.0.0) 
dx.setDownloadPathOfHD("<downloads>\\temp");

If you change the download path and want to know the change immediately, you should use the callback function (success).

dx.setDownloadPathOfHD("<doc>\\temp", function (path) {
  console.log(path);
});

Most of the methods that will be used when using HD applications perform asynchronous operations internally. Asynchronous operation is performed, so the thread does not wait until the operation result is received, and the callback function must be used to receive the result of the request.

Uses

component.setDownloadPath(path[, success]);

Parameters

Version 1.0.0.0 or later

Explanation

Returns an object with current download status information.

When the file is used in the process of downloading, the upload status information can be obtained.

Using this function, the returned object does not have a different value depending on the time, but has only the copied value of the state at the time of the function call.

To get a continuous change in the downloading process, you should use a function such as setTimeout.

function toggleDownloadStatus(isBegin) {
  function downloadProgress() {			
    var dx = dx5.get("dext5"), 
        out = document.getElementById("downstatus-value"), 
        status = dx.getDownloadStatus();
    out.innerHTML = "" + 
      "name: " + status.currentName + "<br/>" + 
      "speed: " + status.totalSpeed + "(sec)<br/>" + 
      "count(completed/total): " + status.completeCount + "/" + status.totalCount + "<br/>" + 
      "current rate: " + status.currentRate + " % <br/>" + 
      "current size(received/total): " + status.currentReceiveSize + "/" + status.currentSize + " (bytes)<br/>" + 
      "current time(past/remained): " + status.currentTime + "/" + status.remainedCurrentTime + "<br/>" + 
      "total rate: " + status.totalRate + " % <br/>" + 
      "total size(received/total): " + status.totalReceiveSize + "/" + status.totalSize + " (bytes)<br/>" + 
      "total time(past/remained): " + status.totalTime + "/" + status.remainedTotalTime + "<br/>" + 
      "";
    if (window.isDownloading === true) {
      setTimeout(downloadProgress, 1000);
    }
  }
  window.isDownloading = isBegin;
  if (isBegin) downloadProgress();
}

Uses

status = component.getDownloadStatus();

Return

An object with download transfer status values.

The following is a description of the properties of the object.

Version 2.0.0.0 or later and earlier than 4.4.0.0

Explanation

To change the download folder of the HD application, open the folder selection dialog window.

Because you download multiple files, you need to set the download location before downloading.

If you do not change the download location, the default location (The DEXTUploadX5 HDM folder in Document folder) is used.

function changePath(id) {
  var dx = dx5.get(id);
  dx.openDownloadPathDialogOfHD();
}

The openDownloadPathDialogOfHD method is used to give the user a chance to select a download path.

If the download path changes, you can use the callback function to get the modified path.

function changePath(id) {
  var dx = dx5.get(id);
  dx.openDownloadPathDialogOfHD(function (path) {
    console.log(path);
  });
}

Uses

component.openDownloadPathDialogOfHD([success]);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Returns the option information set in the HD application as a callback function.

dx.getOptionsOfHD(function (option) {
  // The option parameter is a JSON object that contains option information for the HD application.
});

The options object is:

{
	// If the file is added, the HD program automatically activates.
	autoActivation: true,
	// If the file is added, the HD program automatically starts to download. 
	autoDownload: true,
	// If a file is deleted, its temporary file will be deleted too.
	deleteTemporary: false,
	// If some files are being stopped downloading, they will be started to download when the HD program activates.
	resumeDownload: true,
	// Options that is maintained even if the program is closed
	saveStatus: {
		// waiting or stopped item
		waitStop: true,
		// the item that is been downloading
		downloading: true,
		// the item that completed
		complete: true,
		// the item that occurred some error
		error: true
	}
}

Uses

component.getOptionsOfHD(success);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets options for HD applications at once.

dx.setOptionsOfHD({
	autoActivation: true,
	autoDownload: true,
	deleteTemporary: false,
	resumeDownload: true,
	saveStatus: {
		waitStop: true,
		downloading: true,
		complete: true,
		error: true
	}
}, function () { ... });

Uses

component.setOptionsOfHD(option[, success]);

Parameters

{
	// If the file is added, the HD program automatically activates.
	autoActivation: true,
	// If the file is added, the HD program automatically starts to download. 
	autoDownload: true,
	// If a file is deleted, its temporary file will be deleted too.
	deleteTemporary: false,
	// If some files are being stopped downloading, they will be started to download when the HD program activates.
	resumeDownload: true,
	// Options that is maintained even if the program is closed
	saveStatus: {
		// waiting or stopped item
		waitStop: true,
		// the item that is been downloading
		downloading: true,
		// the item that completed
		complete: true,
		// the item that occurred some error
		error: true
	}
}

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets the value of automatic activation option.

Auto activation refers to switching the HD application program to the active state when the file item to be downloaded is added in the HD application program. If this value is true, the hidden application is shown in windowed mode.

// Change the auto-enable option to true. 
dx.setAutoActivationOptionOfHD(true, function () {
    ...
});

Uses

component.setAutoActivationOptionOfHD(value[, success]);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets the value of the automatic download option.

The automatic download means downloading the HD application program directly when the file item to be downloaded is added in the HD application program.

//  Change the auto-download option to true. 
dx.setAutoDownloadOptionOfHD(true, function () {
    ...
});

Uses

component.setAutoDownloadOptionOfHD(value[, success]);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets the option to delete temporary files.

Deleting temporary files means deleting the temporary files when deleting download items from the application. After you start downloading a file, there is always a temporary file if the download is not completed.

// Change the delete-temporary-files option to true.
dx.setDeleteTemporaryOptionOfHD(true, function () {
    ...
});

Uses

component.setDeleteTemporaryOptionOfHD(value[, success]);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets the download (again) option value.

Re-downloading When a program is terminated with the item that has not been completely downloaded and the program is run again, the unfinished target file is automatically downloaded.

// Change the re-download option to true. 
dx.setResumeDownloadOptionOfHD(true, function () {
    ...
});

Uses

component.setResumeDownloadOptionOfHD(value[, success]);

Parameters

Version 2.4.0.0 or later and earlier than 4.4.0.0

Explanation

Sets the retention target option value after termination.

The end point after termination refers to the item to be maintained when the program is executed again after the end of the program.

// Change the targets to keep after finishing. 
dx.setSaveStatusOptionOfHD(15, function () {
    ...
});

If the downloading value (2) is missing, the item to be automatically downloaded is not retained because there is no item affected by the re-downloading option setting again.

Uses

component.setSaveStatusOptionOfHD(value[, success]);

Parameters

Version 1.1.0.0 or later

Explanation

Stops downloading.

DEXTUploadX5 does not have a button or GUI element to stop downloading itself.

Instead, it provides a function that allows you to stop using a script.

<button type="button" onclick="stop('component-id');">Stop</button>
<script>
function stop(id) {
  dx5.get(id).stopDownloading();
}
</script>

You can use the btnStopDownloading property at the time of component creation to bind automatically.

<button id="btn-stop-downloading" type="button">Stop</button>
<script>
  dx5.create({
    ...,
    // The download stop function is automatically binded.
    btnStopDownloading: "btn-stop-downloading"
  });
</script>

Only multi-file download operations can be aborted. If the target is downloaded using downloadById or the download icon, using the stopDownloading function will not interrupt the operation.

Uses

component.stopDownloading();