Syntax
JavaScript | ![]() |
---|---|
<script type="text/javascript" src="iuembed.js"></script> <script type="text/javascript"> function ImageUploaderID_PackageProgress(PackageIndex, Status, Progress, ValueMax, Value, StatusText) { //...your code... } var iu = new ImageUploaderWriter("ImageUploaderID", 610, 500); //...params... //...other event listeners... iu.addEventListener("PackageProgress", "ImageUploaderID_PackageProgress"); //...other event listeners... iu.writeHtml(); </script> |
Parameters
- PackageIndex
-
Zero-based index of the package (i.e. request) inside the current upload session.
- Status
-
A string value that contains the textual information indicating the current step of the package upload. It can take one of the following values:
Value Description START
The current package upload process has been started. This value is passed to only for the very first event raising. PREPARE
Data is being prepared for the current package upload (thumbnails are generated, request is being constructed, etc). The upload is not started yet. UPLOAD
Data is being uploaded to the server. WAITING
Upload has been broken and Image Uploader waits to make attempt to resume the upload. COMPLETE
The current package upload process has been successfully completed. This value is passed only once and this is always the very last value for all files uploaded in the current package. CANCEL
The upload process is cancelled by the user. This value is passed only once and this is always the very last value for all files uploaded in current package. ERROR
Some error occurred during the upload. This value is passed only once and this is always the very last value for all files uploaded in the current package. - Progress
-
An integer value that contains the degree of completion of the upload or preparation process (in per cents). According to the value of the Status argument the Progress has different meanings:
Value Meaning PREPARE
,UPLOAD
, orWAITING
Percentage of the whole current package upload process completion. START
,COMPLETE
,CANCEL
, orERROR
No meaningful value. - ValueMax
-
An integer value that contains the maximum value of the Value argument for the current upload step. Keep in mind, this value may vary for different event handler calls. According to the value of the Status parameter, the ValueMax has different meanings:
Value Meaning PREPARE
Number of files to be prepared in the current request (package). UPLOAD
Total size of data of the current request (in bytes). WAITING
Total number of milliseconds Image Uploader is waiting between upload resume attempts. START
,COMPLETE
,CANCEL
, orERROR
No meaningful value. - Value
-
An integer value that contains the current value of the progress. Also, if some error occurs, this argument contains the error code. According to the value of the Status argument, the Value has different meanings:
Value Meaning PREPARE
Number of files in the current request (package) that have already been prepared. UPLOAD
Amount of bytes of the current request (package) that have already been sent to the server. WAITING
Number of milliseconds Image Uploader has been waited since the last upload resume attempt. ERROR
One of the error codes:
- 1 - number of selected files is less than number of files allowed for the upload;
- 2 - server, specified in the Action URL was not found (it is down or the server name is misspelled);
- 3 - URL specified in the Action property has an incorrect syntax;
- 4 - some server-side error occurred. The StatusText argument contains the server response which can be used for diagnostics;
- 8 - total size of selected files exceeds the MaxTotalFileSize value;
- 11 - server returned HTTP code 3xx (e.g. 302 or 304) during redirection. The StatusText contains the URL server redirects to;
- 12 - the upload was aborted from the script (using the Stop method);
- 0 - unspecified error.
START
,COMPLETE
, orCANCEL
No meaningful value. - StatusText
-
A string value that contains the textual information for the current step. According to the value of the Status argument, the StatusText has different meanings:
Value Meaning PREPARE
Name of the file which is currently being prepared. UPLOAD
Name of the file which is currently being uploaded to the server. WAITING
The ProgressDialogWaitingForRetryText property value. COMPLETE
orERROR
Response from the server which is returned by the page files are uploaded to. START
orCANCEL
No meaningful value.
Remarks
This event allows you to handle errors which can occur during the current package upload, display progress indicator directly in HTML code, detect when the upload is finished, etc.