Upgrade to ExtJS 3.0.3 - Released 10/11/2009
[extjs.git] / docs / source / swfupload.html
diff --git a/docs/source/swfupload.html b/docs/source/swfupload.html
deleted file mode 100644 (file)
index f7b13b4..0000000
+++ /dev/null
@@ -1,990 +0,0 @@
-<html>\r
-<head>\r
-  <title>The source code</title>\r
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
-</head>\r
-<body  onload="prettyPrint();">\r
-    <pre class="prettyprint lang-js"><div id="prop-Ext.ux.TaskBar.TaskButton-Constructor"></div>/**\r
- * SWFUpload: http://www.swfupload.org, http://swfupload.googlecode.com\r
- *\r
- * mmSWFUpload 1.0: Flash upload dialog - http://profandesign.se/swfupload/,  http://www.vinterwebb.se/\r
- *\r
- * SWFUpload is (c) 2006-2007 Lars Huring, Olov Nilz�n and Mammon Media and is released under the MIT License:\r
- * http://www.opensource.org/licenses/mit-license.php\r
- *\r
- * SWFUpload 2 is (c) 2007-2008 Jake Roberts and is released under the MIT License:\r
- * http://www.opensource.org/licenses/mit-license.php\r
- *\r
- */\r
-\r
-\r
-/* ******************* */\r
-/* Constructor & Init  */\r
-/* ******************* */\r
-var SWFUpload;\r
-\r
-if (SWFUpload == undefined) {\r
-       SWFUpload = function (settings) {\r
-               this.initSWFUpload(settings);\r
-       };\r
-}\r
-\r
-SWFUpload.prototype.initSWFUpload = function (settings) {\r
-       try {\r
-               this.customSettings = {};       // A container where developers can place their own settings associated with this instance.\r
-               this.settings = settings;\r
-               this.eventQueue = [];\r
-               this.movieName = "SWFUpload_" + SWFUpload.movieCount++;\r
-               this.movieElement = null;\r
-\r
-\r
-               // Setup global control tracking\r
-               SWFUpload.instances[this.movieName] = this;\r
-\r
-               // Load the settings.  Load the Flash movie.\r
-               this.initSettings();\r
-               this.loadFlash();\r
-               this.displayDebugInfo();\r
-       } catch (ex) {\r
-               delete SWFUpload.instances[this.movieName];\r
-               throw ex;\r
-       }\r
-};\r
-\r
-/* *************** */\r
-/* Static Members  */\r
-/* *************** */\r
-SWFUpload.instances = {};\r
-SWFUpload.movieCount = 0;\r
-SWFUpload.version = "2.2.0 2009-03-25";\r
-SWFUpload.QUEUE_ERROR = {\r
-       QUEUE_LIMIT_EXCEEDED                    : -100,\r
-       FILE_EXCEEDS_SIZE_LIMIT                 : -110,\r
-       ZERO_BYTE_FILE                                  : -120,\r
-       INVALID_FILETYPE                                : -130\r
-};\r
-SWFUpload.UPLOAD_ERROR = {\r
-       HTTP_ERROR                                              : -200,\r
-       MISSING_UPLOAD_URL                      : -210,\r
-       IO_ERROR                                                : -220,\r
-       SECURITY_ERROR                                  : -230,\r
-       UPLOAD_LIMIT_EXCEEDED                   : -240,\r
-       UPLOAD_FAILED                                   : -250,\r
-       SPECIFIED_FILE_ID_NOT_FOUND             : -260,\r
-       FILE_VALIDATION_FAILED                  : -270,\r
-       FILE_CANCELLED                                  : -280,\r
-       UPLOAD_STOPPED                                  : -290\r
-};\r
-SWFUpload.FILE_STATUS = {\r
-       QUEUED           : -1,\r
-       IN_PROGRESS      : -2,\r
-       ERROR            : -3,\r
-       COMPLETE         : -4,\r
-       CANCELLED        : -5\r
-};\r
-SWFUpload.BUTTON_ACTION = {\r
-       SELECT_FILE  : -100,\r
-       SELECT_FILES : -110,\r
-       START_UPLOAD : -120\r
-};\r
-SWFUpload.CURSOR = {\r
-       ARROW : -1,\r
-       HAND : -2\r
-};\r
-SWFUpload.WINDOW_MODE = {\r
-       WINDOW : "window",\r
-       TRANSPARENT : "transparent",\r
-       OPAQUE : "opaque"\r
-};\r
-\r
-// Private: takes a URL, determines if it is relative and converts to an absolute URL\r
-// using the current site. Only processes the URL if it can, otherwise returns the URL untouched\r
-SWFUpload.completeURL = function(url) {\r
-       if (typeof(url) !== "string" || url.match(/^https?:\/\//i) || url.match(/^\//)) {\r
-               return url;\r
-       }\r
-       \r
-       var currentURL = window.location.protocol + "//" + window.location.hostname + (window.location.port ? ":" + window.location.port : "");\r
-       \r
-       var indexSlash = window.location.pathname.lastIndexOf("/");\r
-       if (indexSlash <= 0) {\r
-               path = "/";\r
-       } else {\r
-               path = window.location.pathname.substr(0, indexSlash) + "/";\r
-       }\r
-       \r
-       return /*currentURL +*/ path + url;\r
-       \r
-};\r
-\r
-\r
-/* ******************** */\r
-/* Instance Members  */\r
-/* ******************** */\r
-\r
-// Private: initSettings ensures that all the\r
-// settings are set, getting a default value if one was not assigned.\r
-SWFUpload.prototype.initSettings = function () {\r
-       this.ensureDefault = function (settingName, defaultValue) {\r
-               this.settings[settingName] = (this.settings[settingName] == undefined) ? defaultValue : this.settings[settingName];\r
-       };\r
-       \r
-       // Upload backend settings\r
-       this.ensureDefault("upload_url", "");\r
-       this.ensureDefault("preserve_relative_urls", false);\r
-       this.ensureDefault("file_post_name", "Filedata");\r
-       this.ensureDefault("post_params", {});\r
-       this.ensureDefault("use_query_string", false);\r
-       this.ensureDefault("requeue_on_error", false);\r
-       this.ensureDefault("http_success", []);\r
-       this.ensureDefault("assume_success_timeout", 0);\r
-       \r
-       // File Settings\r
-       this.ensureDefault("file_types", "*.*");\r
-       this.ensureDefault("file_types_description", "All Files");\r
-       this.ensureDefault("file_size_limit", 0);       // Default zero means "unlimited"\r
-       this.ensureDefault("file_upload_limit", 0);\r
-       this.ensureDefault("file_queue_limit", 0);\r
-\r
-       // Flash Settings\r
-       this.ensureDefault("flash_url", "swfupload.swf");\r
-       this.ensureDefault("prevent_swf_caching", true);\r
-       \r
-       // Button Settings\r
-       this.ensureDefault("button_image_url", "");\r
-       this.ensureDefault("button_width", 1);\r
-       this.ensureDefault("button_height", 1);\r
-       this.ensureDefault("button_text", "");\r
-       this.ensureDefault("button_text_style", "color: #000000; font-size: 16pt;");\r
-       this.ensureDefault("button_text_top_padding", 0);\r
-       this.ensureDefault("button_text_left_padding", 0);\r
-       this.ensureDefault("button_action", SWFUpload.BUTTON_ACTION.SELECT_FILES);\r
-       this.ensureDefault("button_disabled", false);\r
-       this.ensureDefault("button_placeholder_id", "");\r
-       this.ensureDefault("button_placeholder", null);\r
-       this.ensureDefault("button_cursor", SWFUpload.CURSOR.ARROW);\r
-       this.ensureDefault("button_window_mode", SWFUpload.WINDOW_MODE.WINDOW);\r
-       \r
-       // Debug Settings\r
-       this.ensureDefault("debug", false);\r
-       this.settings.debug_enabled = this.settings.debug;      // Here to maintain v2 API\r
-       \r
-       // Event Handlers\r
-       this.settings.return_upload_start_handler = this.returnUploadStart;\r
-       this.ensureDefault("swfupload_loaded_handler", null);\r
-       this.ensureDefault("file_dialog_start_handler", null);\r
-       this.ensureDefault("file_queued_handler", null);\r
-       this.ensureDefault("file_queue_error_handler", null);\r
-       this.ensureDefault("file_dialog_complete_handler", null);\r
-       \r
-       this.ensureDefault("upload_start_handler", null);\r
-       this.ensureDefault("upload_progress_handler", null);\r
-       this.ensureDefault("upload_error_handler", null);\r
-       this.ensureDefault("upload_success_handler", null);\r
-       this.ensureDefault("upload_complete_handler", null);\r
-       \r
-       this.ensureDefault("debug_handler", this.debugMessage);\r
-\r
-       this.ensureDefault("custom_settings", {});\r
-\r
-       // Other settings\r
-       this.customSettings = this.settings.custom_settings;\r
-       \r
-       // Update the flash url if needed\r
-       if (!!this.settings.prevent_swf_caching) {\r
-               this.settings.flash_url = this.settings.flash_url + (this.settings.flash_url.indexOf("?") < 0 ? "?" : "&") + "preventswfcaching=" + new Date().getTime();\r
-       }\r
-       \r
-       if (!this.settings.preserve_relative_urls) {\r
-               //this.settings.flash_url = SWFUpload.completeURL(this.settings.flash_url);     // Don't need to do this one since flash doesn't look at it\r
-               this.settings.upload_url = SWFUpload.completeURL(this.settings.upload_url);\r
-               this.settings.button_image_url = SWFUpload.completeURL(this.settings.button_image_url);\r
-       }\r
-       \r
-       delete this.ensureDefault;\r
-};\r
-\r
-// Private: loadFlash replaces the button_placeholder element with the flash movie.\r
-SWFUpload.prototype.loadFlash = function () {\r
-       var targetElement, tempParent;\r
-\r
-       // Make sure an element with the ID we are going to use doesn't already exist\r
-       if (document.getElementById(this.movieName) !== null) {\r
-               throw "ID " + this.movieName + " is already in use. The Flash Object could not be added";\r
-       }\r
-\r
-       // Get the element where we will be placing the flash movie\r
-       targetElement = document.getElementById(this.settings.button_placeholder_id) || this.settings.button_placeholder;\r
-\r
-       if (targetElement == undefined) {\r
-               throw "Could not find the placeholder element: " + this.settings.button_placeholder_id;\r
-       }\r
-\r
-       // Append the container and load the flash\r
-       tempParent = document.createElement("div");\r
-       tempParent.innerHTML = this.getFlashHTML();     // Using innerHTML is non-standard but the only sensible way to dynamically add Flash in IE (and maybe other browsers)\r
-       targetElement.parentNode.replaceChild(tempParent.firstChild, targetElement);\r
-\r
-       // Fix IE Flash/Form bug\r
-       if (window[this.movieName] == undefined) {\r
-               window[this.movieName] = this.getMovieElement();\r
-       }\r
-       \r
-};\r
-\r
-// Private: getFlashHTML generates the object tag needed to embed the flash in to the document\r
-SWFUpload.prototype.getFlashHTML = function () {\r
-       // Flash Satay object syntax: http://www.alistapart.com/articles/flashsatay\r
-       return ['<object id="', this.movieName, '" type="application/x-shockwave-flash" data="', this.settings.flash_url, '" width="', this.settings.button_width, '" height="', this.settings.button_height, '" class="swfupload">',\r
-                               '<param name="wmode" value="', this.settings.button_window_mode, '" />',\r
-                               '<param name="movie" value="', this.settings.flash_url, '" />',\r
-                               '<param name="quality" value="high" />',\r
-                               '<param name="menu" value="false" />',\r
-                               '<param name="allowScriptAccess" value="always" />',\r
-                               '<param name="flashvars" value="' + this.getFlashVars() + '" />',\r
-                               '</object>'].join("");\r
-};\r
-\r
-// Private: getFlashVars builds the parameter string that will be passed\r
-// to flash in the flashvars param.\r
-SWFUpload.prototype.getFlashVars = function () {\r
-       // Build a string from the post param object\r
-       var paramString = this.buildParamString();\r
-       var httpSuccessString = this.settings.http_success.join(",");\r
-       \r
-       // Build the parameter string\r
-       return ["movieName=", encodeURIComponent(this.movieName),\r
-                       "&amp;uploadURL=", encodeURIComponent(this.settings.upload_url),\r
-                       "&amp;useQueryString=", encodeURIComponent(this.settings.use_query_string),\r
-                       "&amp;requeueOnError=", encodeURIComponent(this.settings.requeue_on_error),\r
-                       "&amp;httpSuccess=", encodeURIComponent(httpSuccessString),\r
-                       "&amp;assumeSuccessTimeout=", encodeURIComponent(this.settings.assume_success_timeout),\r
-                       "&amp;params=", encodeURIComponent(paramString),\r
-                       "&amp;filePostName=", encodeURIComponent(this.settings.file_post_name),\r
-                       "&amp;fileTypes=", encodeURIComponent(this.settings.file_types),\r
-                       "&amp;fileTypesDescription=", encodeURIComponent(this.settings.file_types_description),\r
-                       "&amp;fileSizeLimit=", encodeURIComponent(this.settings.file_size_limit),\r
-                       "&amp;fileUploadLimit=", encodeURIComponent(this.settings.file_upload_limit),\r
-                       "&amp;fileQueueLimit=", encodeURIComponent(this.settings.file_queue_limit),\r
-                       "&amp;debugEnabled=", encodeURIComponent(this.settings.debug_enabled),\r
-                       "&amp;buttonImageURL=", encodeURIComponent(this.settings.button_image_url),\r
-                       "&amp;buttonWidth=", encodeURIComponent(this.settings.button_width),\r
-                       "&amp;buttonHeight=", encodeURIComponent(this.settings.button_height),\r
-                       "&amp;buttonText=", encodeURIComponent(this.settings.button_text),\r
-                       "&amp;buttonTextTopPadding=", encodeURIComponent(this.settings.button_text_top_padding),\r
-                       "&amp;buttonTextLeftPadding=", encodeURIComponent(this.settings.button_text_left_padding),\r
-                       "&amp;buttonTextStyle=", encodeURIComponent(this.settings.button_text_style),\r
-                       "&amp;buttonAction=", encodeURIComponent(this.settings.button_action),\r
-                       "&amp;buttonDisabled=", encodeURIComponent(this.settings.button_disabled),\r
-                       "&amp;buttonCursor=", encodeURIComponent(this.settings.button_cursor)\r
-               ].join("");\r
-};\r
-\r
-// Public: getMovieElement retrieves the DOM reference to the Flash element added by SWFUpload\r
-// The element is cached after the first lookup\r
-SWFUpload.prototype.getMovieElement = function () {\r
-       if (this.movieElement == undefined) {\r
-               this.movieElement = document.getElementById(this.movieName);\r
-       }\r
-\r
-       if (this.movieElement === null) {\r
-               throw "Could not find Flash element";\r
-       }\r
-       \r
-       return this.movieElement;\r
-};\r
-\r
-// Private: buildParamString takes the name/value pairs in the post_params setting object\r
-// and joins them up in to a string formatted "name=value&amp;name=value"\r
-SWFUpload.prototype.buildParamString = function () {\r
-       var postParams = this.settings.post_params; \r
-       var paramStringPairs = [];\r
-\r
-       if (typeof(postParams) === "object") {\r
-               for (var name in postParams) {\r
-                       if (postParams.hasOwnProperty(name)) {\r
-                               paramStringPairs.push(encodeURIComponent(name.toString()) + "=" + encodeURIComponent(postParams[name].toString()));\r
-                       }\r
-               }\r
-       }\r
-\r
-       return paramStringPairs.join("&amp;");\r
-};\r
-\r
-// Public: Used to remove a SWFUpload instance from the page. This method strives to remove\r
-// all references to the SWF, and other objects so memory is properly freed.\r
-// Returns true if everything was destroyed. Returns a false if a failure occurs leaving SWFUpload in an inconsistant state.\r
-// Credits: Major improvements provided by steffen\r
-SWFUpload.prototype.destroy = function () {\r
-       try {\r
-               // Make sure Flash is done before we try to remove it\r
-               this.cancelUpload(null, false);\r
-               \r
-\r
-               // Remove the SWFUpload DOM nodes\r
-               var movieElement = null;\r
-               movieElement = this.getMovieElement();\r
-               \r
-               if (movieElement && typeof(movieElement.CallFunction) === "unknown") { // We only want to do this in IE\r
-                       // Loop through all the movie's properties and remove all function references (DOM/JS IE 6/7 memory leak workaround)\r
-                       for (var i in movieElement) {\r
-                               try {\r
-                                       if (typeof(movieElement[i]) === "function") {\r
-                                               movieElement[i] = null;\r
-                                       }\r
-                               } catch (ex1) {}\r
-                       }\r
-\r
-                       // Remove the Movie Element from the page\r
-                       try {\r
-                               movieElement.parentNode.removeChild(movieElement);\r
-                       } catch (ex) {}\r
-               }\r
-               \r
-               // Remove IE form fix reference\r
-               window[this.movieName] = null;\r
-\r
-               // Destroy other references\r
-               SWFUpload.instances[this.movieName] = null;\r
-               delete SWFUpload.instances[this.movieName];\r
-\r
-               this.movieElement = null;\r
-               this.settings = null;\r
-               this.customSettings = null;\r
-               this.eventQueue = null;\r
-               this.movieName = null;\r
-               \r
-               \r
-               return true;\r
-       } catch (ex2) {\r
-               return false;\r
-       }\r
-};\r
-\r
-\r
-// Public: displayDebugInfo prints out settings and configuration\r
-// information about this SWFUpload instance.\r
-// This function (and any references to it) can be deleted when placing\r
-// SWFUpload in production.\r
-SWFUpload.prototype.displayDebugInfo = function () {\r
-       this.debug(\r
-               [\r
-                       "---SWFUpload Instance Info---\n",\r
-                       "Version: ", SWFUpload.version, "\n",\r
-                       "Movie Name: ", this.movieName, "\n",\r
-                       "Settings:\n",\r
-                       "\t", "upload_url:               ", this.settings.upload_url, "\n",\r
-                       "\t", "flash_url:                ", this.settings.flash_url, "\n",\r
-                       "\t", "use_query_string:         ", this.settings.use_query_string.toString(), "\n",\r
-                       "\t", "requeue_on_error:         ", this.settings.requeue_on_error.toString(), "\n",\r
-                       "\t", "http_success:             ", this.settings.http_success.join(", "), "\n",\r
-                       "\t", "assume_success_timeout:   ", this.settings.assume_success_timeout, "\n",\r
-                       "\t", "file_post_name:           ", this.settings.file_post_name, "\n",\r
-                       "\t", "post_params:              ", this.settings.post_params.toString(), "\n",\r
-                       "\t", "file_types:               ", this.settings.file_types, "\n",\r
-                       "\t", "file_types_description:   ", this.settings.file_types_description, "\n",\r
-                       "\t", "file_size_limit:          ", this.settings.file_size_limit, "\n",\r
-                       "\t", "file_upload_limit:        ", this.settings.file_upload_limit, "\n",\r
-                       "\t", "file_queue_limit:         ", this.settings.file_queue_limit, "\n",\r
-                       "\t", "debug:                    ", this.settings.debug.toString(), "\n",\r
-\r
-                       "\t", "prevent_swf_caching:      ", this.settings.prevent_swf_caching.toString(), "\n",\r
-\r
-                       "\t", "button_placeholder_id:    ", this.settings.button_placeholder_id.toString(), "\n",\r
-                       "\t", "button_placeholder:       ", (this.settings.button_placeholder ? "Set" : "Not Set"), "\n",\r
-                       "\t", "button_image_url:         ", this.settings.button_image_url.toString(), "\n",\r
-                       "\t", "button_width:             ", this.settings.button_width.toString(), "\n",\r
-                       "\t", "button_height:            ", this.settings.button_height.toString(), "\n",\r
-                       "\t", "button_text:              ", this.settings.button_text.toString(), "\n",\r
-                       "\t", "button_text_style:        ", this.settings.button_text_style.toString(), "\n",\r
-                       "\t", "button_text_top_padding:  ", this.settings.button_text_top_padding.toString(), "\n",\r
-                       "\t", "button_text_left_padding: ", this.settings.button_text_left_padding.toString(), "\n",\r
-                       "\t", "button_action:            ", this.settings.button_action.toString(), "\n",\r
-                       "\t", "button_disabled:          ", this.settings.button_disabled.toString(), "\n",\r
-\r
-                       "\t", "custom_settings:          ", this.settings.custom_settings.toString(), "\n",\r
-                       "Event Handlers:\n",\r
-                       "\t", "swfupload_loaded_handler assigned:  ", (typeof this.settings.swfupload_loaded_handler === "function").toString(), "\n",\r
-                       "\t", "file_dialog_start_handler assigned: ", (typeof this.settings.file_dialog_start_handler === "function").toString(), "\n",\r
-                       "\t", "file_queued_handler assigned:       ", (typeof this.settings.file_queued_handler === "function").toString(), "\n",\r
-                       "\t", "file_queue_error_handler assigned:  ", (typeof this.settings.file_queue_error_handler === "function").toString(), "\n",\r
-                       "\t", "upload_start_handler assigned:      ", (typeof this.settings.upload_start_handler === "function").toString(), "\n",\r
-                       "\t", "upload_progress_handler assigned:   ", (typeof this.settings.upload_progress_handler === "function").toString(), "\n",\r
-                       "\t", "upload_error_handler assigned:      ", (typeof this.settings.upload_error_handler === "function").toString(), "\n",\r
-                       "\t", "upload_success_handler assigned:    ", (typeof this.settings.upload_success_handler === "function").toString(), "\n",\r
-                       "\t", "upload_complete_handler assigned:   ", (typeof this.settings.upload_complete_handler === "function").toString(), "\n",\r
-                       "\t", "debug_handler assigned:             ", (typeof this.settings.debug_handler === "function").toString(), "\n"\r
-               ].join("")\r
-       );\r
-};\r
-\r
-/* Note: addSetting and getSetting are no longer used by SWFUpload but are included\r
-       the maintain v2 API compatibility\r
-*/\r
-// Public: (Deprecated) addSetting adds a setting value. If the value given is undefined or null then the default_value is used.\r
-SWFUpload.prototype.addSetting = function (name, value, default_value) {\r
-    if (value == undefined) {\r
-        return (this.settings[name] = default_value);\r
-    } else {\r
-        return (this.settings[name] = value);\r
-       }\r
-};\r
-\r
-// Public: (Deprecated) getSetting gets a setting. Returns an empty string if the setting was not found.\r
-SWFUpload.prototype.getSetting = function (name) {\r
-    if (this.settings[name] != undefined) {\r
-        return this.settings[name];\r
-       }\r
-\r
-    return "";\r
-};\r
-\r
-\r
-\r
-// Private: callFlash handles function calls made to the Flash element.\r
-// Calls are made with a setTimeout for some functions to work around\r
-// bugs in the ExternalInterface library.\r
-SWFUpload.prototype.callFlash = function (functionName, argumentArray) {\r
-       argumentArray = argumentArray || [];\r
-       \r
-       var movieElement = this.getMovieElement();\r
-       var returnValue, returnString;\r
-\r
-       // Flash's method if calling ExternalInterface methods (code adapted from MooTools).\r
-       try {\r
-               returnString = movieElement.CallFunction('<invoke name="' + functionName + '" returntype="javascript">' + __flash__argumentsToXML(argumentArray, 0) + '</invoke>');\r
-               returnValue = eval(returnString);\r
-       } catch (ex) {\r
-               throw "Call to " + functionName + " failed";\r
-       }\r
-       \r
-       // Unescape file post param values\r
-       if (returnValue != undefined && typeof returnValue.post === "object") {\r
-               returnValue = this.unescapeFilePostParams(returnValue);\r
-       }\r
-\r
-       return returnValue;\r
-};\r
-\r
-/* *****************************\r
-       -- Flash control methods --\r
-       Your UI should use these\r
-       to operate SWFUpload\r
-   ***************************** */\r
-\r
-// WARNING: this function does not work in Flash Player 10\r
-// Public: selectFile causes a File Selection Dialog window to appear.  This\r
-// dialog only allows 1 file to be selected.\r
-SWFUpload.prototype.selectFile = function () {\r
-       this.callFlash("SelectFile");\r
-};\r
-\r
-// WARNING: this function does not work in Flash Player 10\r
-// Public: selectFiles causes a File Selection Dialog window to appear/ This\r
-// dialog allows the user to select any number of files\r
-// Flash Bug Warning: Flash limits the number of selectable files based on the combined length of the file names.\r
-// If the selection name length is too long the dialog will fail in an unpredictable manner.  There is no work-around\r
-// for this bug.\r
-SWFUpload.prototype.selectFiles = function () {\r
-       this.callFlash("SelectFiles");\r
-};\r
-\r
-\r
-// Public: startUpload starts uploading the first file in the queue unless\r
-// the optional parameter 'fileID' specifies the ID \r
-SWFUpload.prototype.startUpload = function (fileID) {\r
-       this.callFlash("StartUpload", [fileID]);\r
-};\r
-\r
-// Public: cancelUpload cancels any queued file.  The fileID parameter may be the file ID or index.\r
-// If you do not specify a fileID the current uploading file or first file in the queue is cancelled.\r
-// If you do not want the uploadError event to trigger you can specify false for the triggerErrorEvent parameter.\r
-SWFUpload.prototype.cancelUpload = function (fileID, triggerErrorEvent) {\r
-       if (triggerErrorEvent !== false) {\r
-               triggerErrorEvent = true;\r
-       }\r
-       this.callFlash("CancelUpload", [fileID, triggerErrorEvent]);\r
-};\r
-\r
-// Public: stopUpload stops the current upload and requeues the file at the beginning of the queue.\r
-// If nothing is currently uploading then nothing happens.\r
-SWFUpload.prototype.stopUpload = function () {\r
-       this.callFlash("StopUpload");\r
-};\r
-\r
-/* ************************\r
- * Settings methods\r
- *   These methods change the SWFUpload settings.\r
- *   SWFUpload settings should not be changed directly on the settings object\r
- *   since many of the settings need to be passed to Flash in order to take\r
- *   effect.\r
- * *********************** */\r
-\r
-// Public: getStats gets the file statistics object.\r
-SWFUpload.prototype.getStats = function () {\r
-       return this.callFlash("GetStats");\r
-};\r
-\r
-// Public: setStats changes the SWFUpload statistics.  You shouldn't need to \r
-// change the statistics but you can.  Changing the statistics does not\r
-// affect SWFUpload accept for the successful_uploads count which is used\r
-// by the upload_limit setting to determine how many files the user may upload.\r
-SWFUpload.prototype.setStats = function (statsObject) {\r
-       this.callFlash("SetStats", [statsObject]);\r
-};\r
-\r
-// Public: getFile retrieves a File object by ID or Index.  If the file is\r
-// not found then 'null' is returned.\r
-SWFUpload.prototype.getFile = function (fileID) {\r
-       if (typeof(fileID) === "number") {\r
-               return this.callFlash("GetFileByIndex", [fileID]);\r
-       } else {\r
-               return this.callFlash("GetFile", [fileID]);\r
-       }\r
-};\r
-\r
-// Public: addFileParam sets a name/value pair that will be posted with the\r
-// file specified by the Files ID.  If the name already exists then the\r
-// exiting value will be overwritten.\r
-SWFUpload.prototype.addFileParam = function (fileID, name, value) {\r
-       return this.callFlash("AddFileParam", [fileID, name, value]);\r
-};\r
-\r
-// Public: removeFileParam removes a previously set (by addFileParam) name/value\r
-// pair from the specified file.\r
-SWFUpload.prototype.removeFileParam = function (fileID, name) {\r
-       this.callFlash("RemoveFileParam", [fileID, name]);\r
-};\r
-\r
-// Public: setUploadUrl changes the upload_url setting.\r
-SWFUpload.prototype.setUploadURL = function (url) {\r
-       this.settings.upload_url = url.toString();\r
-       this.callFlash("SetUploadURL", [url]);\r
-};\r
-\r
-// Public: setPostParams changes the post_params setting\r
-SWFUpload.prototype.setPostParams = function (paramsObject) {\r
-       this.settings.post_params = paramsObject;\r
-       this.callFlash("SetPostParams", [paramsObject]);\r
-};\r
-\r
-// Public: addPostParam adds post name/value pair.  Each name can have only one value.\r
-SWFUpload.prototype.addPostParam = function (name, value) {\r
-       this.settings.post_params[name] = value;\r
-       this.callFlash("SetPostParams", [this.settings.post_params]);\r
-};\r
-\r
-// Public: removePostParam deletes post name/value pair.\r
-SWFUpload.prototype.removePostParam = function (name) {\r
-       delete this.settings.post_params[name];\r
-       this.callFlash("SetPostParams", [this.settings.post_params]);\r
-};\r
-\r
-// Public: setFileTypes changes the file_types setting and the file_types_description setting\r
-SWFUpload.prototype.setFileTypes = function (types, description) {\r
-       this.settings.file_types = types;\r
-       this.settings.file_types_description = description;\r
-       this.callFlash("SetFileTypes", [types, description]);\r
-};\r
-\r
-// Public: setFileSizeLimit changes the file_size_limit setting\r
-SWFUpload.prototype.setFileSizeLimit = function (fileSizeLimit) {\r
-       this.settings.file_size_limit = fileSizeLimit;\r
-       this.callFlash("SetFileSizeLimit", [fileSizeLimit]);\r
-};\r
-\r
-// Public: setFileUploadLimit changes the file_upload_limit setting\r
-SWFUpload.prototype.setFileUploadLimit = function (fileUploadLimit) {\r
-       this.settings.file_upload_limit = fileUploadLimit;\r
-       this.callFlash("SetFileUploadLimit", [fileUploadLimit]);\r
-};\r
-\r
-// Public: setFileQueueLimit changes the file_queue_limit setting\r
-SWFUpload.prototype.setFileQueueLimit = function (fileQueueLimit) {\r
-       this.settings.file_queue_limit = fileQueueLimit;\r
-       this.callFlash("SetFileQueueLimit", [fileQueueLimit]);\r
-};\r
-\r
-// Public: setFilePostName changes the file_post_name setting\r
-SWFUpload.prototype.setFilePostName = function (filePostName) {\r
-       this.settings.file_post_name = filePostName;\r
-       this.callFlash("SetFilePostName", [filePostName]);\r
-};\r
-\r
-// Public: setUseQueryString changes the use_query_string setting\r
-SWFUpload.prototype.setUseQueryString = function (useQueryString) {\r
-       this.settings.use_query_string = useQueryString;\r
-       this.callFlash("SetUseQueryString", [useQueryString]);\r
-};\r
-\r
-// Public: setRequeueOnError changes the requeue_on_error setting\r
-SWFUpload.prototype.setRequeueOnError = function (requeueOnError) {\r
-       this.settings.requeue_on_error = requeueOnError;\r
-       this.callFlash("SetRequeueOnError", [requeueOnError]);\r
-};\r
-\r
-// Public: setHTTPSuccess changes the http_success setting\r
-SWFUpload.prototype.setHTTPSuccess = function (http_status_codes) {\r
-       if (typeof http_status_codes === "string") {\r
-               http_status_codes = http_status_codes.replace(" ", "").split(",");\r
-       }\r
-       \r
-       this.settings.http_success = http_status_codes;\r
-       this.callFlash("SetHTTPSuccess", [http_status_codes]);\r
-};\r
-\r
-// Public: setHTTPSuccess changes the http_success setting\r
-SWFUpload.prototype.setAssumeSuccessTimeout = function (timeout_seconds) {\r
-       this.settings.assume_success_timeout = timeout_seconds;\r
-       this.callFlash("SetAssumeSuccessTimeout", [timeout_seconds]);\r
-};\r
-\r
-// Public: setDebugEnabled changes the debug_enabled setting\r
-SWFUpload.prototype.setDebugEnabled = function (debugEnabled) {\r
-       this.settings.debug_enabled = debugEnabled;\r
-       this.callFlash("SetDebugEnabled", [debugEnabled]);\r
-};\r
-\r
-// Public: setButtonImageURL loads a button image sprite\r
-SWFUpload.prototype.setButtonImageURL = function (buttonImageURL) {\r
-       if (buttonImageURL == undefined) {\r
-               buttonImageURL = "";\r
-       }\r
-       \r
-       this.settings.button_image_url = buttonImageURL;\r
-       this.callFlash("SetButtonImageURL", [buttonImageURL]);\r
-};\r
-\r
-// Public: setButtonDimensions resizes the Flash Movie and button\r
-SWFUpload.prototype.setButtonDimensions = function (width, height) {\r
-       this.settings.button_width = width;\r
-       this.settings.button_height = height;\r
-       \r
-       var movie = this.getMovieElement();\r
-       if (movie != undefined) {\r
-               movie.style.width = width + "px";\r
-               movie.style.height = height + "px";\r
-       }\r
-       \r
-       this.callFlash("SetButtonDimensions", [width, height]);\r
-};\r
-// Public: setButtonText Changes the text overlaid on the button\r
-SWFUpload.prototype.setButtonText = function (html) {\r
-       this.settings.button_text = html;\r
-       this.callFlash("SetButtonText", [html]);\r
-};\r
-// Public: setButtonTextPadding changes the top and left padding of the text overlay\r
-SWFUpload.prototype.setButtonTextPadding = function (left, top) {\r
-       this.settings.button_text_top_padding = top;\r
-       this.settings.button_text_left_padding = left;\r
-       this.callFlash("SetButtonTextPadding", [left, top]);\r
-};\r
-\r
-// Public: setButtonTextStyle changes the CSS used to style the HTML/Text overlaid on the button\r
-SWFUpload.prototype.setButtonTextStyle = function (css) {\r
-       this.settings.button_text_style = css;\r
-       this.callFlash("SetButtonTextStyle", [css]);\r
-};\r
-// Public: setButtonDisabled disables/enables the button\r
-SWFUpload.prototype.setButtonDisabled = function (isDisabled) {\r
-       this.settings.button_disabled = isDisabled;\r
-       this.callFlash("SetButtonDisabled", [isDisabled]);\r
-};\r
-// Public: setButtonAction sets the action that occurs when the button is clicked\r
-SWFUpload.prototype.setButtonAction = function (buttonAction) {\r
-       this.settings.button_action = buttonAction;\r
-       this.callFlash("SetButtonAction", [buttonAction]);\r
-};\r
-\r
-// Public: setButtonCursor changes the mouse cursor displayed when hovering over the button\r
-SWFUpload.prototype.setButtonCursor = function (cursor) {\r
-       this.settings.button_cursor = cursor;\r
-       this.callFlash("SetButtonCursor", [cursor]);\r
-};\r
-\r
-/* *******************************\r
-       Flash Event Interfaces\r
-       These functions are used by Flash to trigger the various\r
-       events.\r
-       \r
-       All these functions a Private.\r
-       \r
-       Because the ExternalInterface library is buggy the event calls\r
-       are added to a queue and the queue then executed by a setTimeout.\r
-       This ensures that events are executed in a determinate order and that\r
-       the ExternalInterface bugs are avoided.\r
-******************************* */\r
-\r
-SWFUpload.prototype.queueEvent = function (handlerName, argumentArray) {\r
-       // Warning: Don't call this.debug inside here or you'll create an infinite loop\r
-       \r
-       if (argumentArray == undefined) {\r
-               argumentArray = [];\r
-       } else if (!(argumentArray instanceof Array)) {\r
-               argumentArray = [argumentArray];\r
-       }\r
-       \r
-       var self = this;\r
-       if (typeof this.settings[handlerName] === "function") {\r
-               // Queue the event\r
-               this.eventQueue.push(function () {\r
-                       this.settings[handlerName].apply(this, argumentArray);\r
-               });\r
-               \r
-               // Execute the next queued event\r
-               setTimeout(function () {\r
-                       self.executeNextEvent();\r
-               }, 0);\r
-               \r
-       } else if (this.settings[handlerName] !== null) {\r
-               throw "Event handler " + handlerName + " is unknown or is not a function";\r
-       }\r
-};\r
-\r
-// Private: Causes the next event in the queue to be executed.  Since events are queued using a setTimeout\r
-// we must queue them in order to garentee that they are executed in order.\r
-SWFUpload.prototype.executeNextEvent = function () {\r
-       // Warning: Don't call this.debug inside here or you'll create an infinite loop\r
-\r
-       var  f = this.eventQueue ? this.eventQueue.shift() : null;\r
-       if (typeof(f) === "function") {\r
-               f.apply(this);\r
-       }\r
-};\r
-\r
-// Private: unescapeFileParams is part of a workaround for a flash bug where objects passed through ExternalInterface cannot have\r
-// properties that contain characters that are not valid for JavaScript identifiers. To work around this\r
-// the Flash Component escapes the parameter names and we must unescape again before passing them along.\r
-SWFUpload.prototype.unescapeFilePostParams = function (file) {\r
-       var reg = /[$]([0-9a-f]{4})/i;\r
-       var unescapedPost = {};\r
-       var uk;\r
-\r
-       if (file != undefined) {\r
-               for (var k in file.post) {\r
-                       if (file.post.hasOwnProperty(k)) {\r
-                               uk = k;\r
-                               var match;\r
-                               while ((match = reg.exec(uk)) !== null) {\r
-                                       uk = uk.replace(match[0], String.fromCharCode(parseInt("0x" + match[1], 16)));\r
-                               }\r
-                               unescapedPost[uk] = file.post[k];\r
-                       }\r
-               }\r
-\r
-               file.post = unescapedPost;\r
-       }\r
-\r
-       return file;\r
-};\r
-\r
-// Private: Called by Flash to see if JS can call in to Flash (test if External Interface is working)\r
-SWFUpload.prototype.testExternalInterface = function () {\r
-       try {\r
-               return this.callFlash("TestExternalInterface");\r
-       } catch (ex) {\r
-               return false;\r
-       }\r
-};\r
-\r
-// Private: This event is called by Flash when it has finished loading. Don't modify this.\r
-// Use the swfupload_loaded_handler event setting to execute custom code when SWFUpload has loaded.\r
-SWFUpload.prototype.flashReady = function () {\r
-       // Check that the movie element is loaded correctly with its ExternalInterface methods defined\r
-       var movieElement = this.getMovieElement();\r
-\r
-       if (!movieElement) {\r
-               this.debug("Flash called back ready but the flash movie can't be found.");\r
-               return;\r
-       }\r
-\r
-       this.cleanUp(movieElement);\r
-       \r
-       this.queueEvent("swfupload_loaded_handler");\r
-};\r
-\r
-// Private: removes Flash added fuctions to the DOM node to prevent memory leaks in IE.\r
-// This function is called by Flash each time the ExternalInterface functions are created.\r
-SWFUpload.prototype.cleanUp = function (movieElement) {\r
-       // Pro-actively unhook all the Flash functions\r
-       try {\r
-               if (this.movieElement && typeof(movieElement.CallFunction) === "unknown") { // We only want to do this in IE\r
-                       this.debug("Removing Flash functions hooks (this should only run in IE and should prevent memory leaks)");\r
-                       for (var key in movieElement) {\r
-                               try {\r
-                                       if (typeof(movieElement[key]) === "function") {\r
-                                               movieElement[key] = null;\r
-                                       }\r
-                               } catch (ex) {\r
-                               }\r
-                       }\r
-               }\r
-       } catch (ex1) {\r
-       \r
-       }\r
-\r
-       // Fix Flashes own cleanup code so if the SWFMovie was removed from the page\r
-       // it doesn't display errors.\r
-       window["__flash__removeCallback"] = function (instance, name) {\r
-               try {\r
-                       if (instance) {\r
-                               instance[name] = null;\r
-                       }\r
-               } catch (flashEx) {\r
-               \r
-               }\r
-       };\r
-\r
-};\r
-\r
-\r
-/* This is a chance to do something before the browse window opens */\r
-SWFUpload.prototype.fileDialogStart = function () {\r
-       this.queueEvent("file_dialog_start_handler");\r
-};\r
-\r
-\r
-/* Called when a file is successfully added to the queue. */\r
-SWFUpload.prototype.fileQueued = function (file) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("file_queued_handler", file);\r
-};\r
-\r
-\r
-/* Handle errors that occur when an attempt to queue a file fails. */\r
-SWFUpload.prototype.fileQueueError = function (file, errorCode, message) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("file_queue_error_handler", [file, errorCode, message]);\r
-};\r
-\r
-/* Called after the file dialog has closed and the selected files have been queued.\r
-       You could call startUpload here if you want the queued files to begin uploading immediately. */\r
-SWFUpload.prototype.fileDialogComplete = function (numFilesSelected, numFilesQueued, numFilesInQueue) {\r
-       this.queueEvent("file_dialog_complete_handler", [numFilesSelected, numFilesQueued, numFilesInQueue]);\r
-};\r
-\r
-SWFUpload.prototype.uploadStart = function (file) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("return_upload_start_handler", file);\r
-};\r
-\r
-SWFUpload.prototype.returnUploadStart = function (file) {\r
-       var returnValue;\r
-       if (typeof this.settings.upload_start_handler === "function") {\r
-               file = this.unescapeFilePostParams(file);\r
-               returnValue = this.settings.upload_start_handler.call(this, file);\r
-       } else if (this.settings.upload_start_handler != undefined) {\r
-               throw "upload_start_handler must be a function";\r
-       }\r
-\r
-       // Convert undefined to true so if nothing is returned from the upload_start_handler it is\r
-       // interpretted as 'true'.\r
-       if (returnValue === undefined) {\r
-               returnValue = true;\r
-       }\r
-       \r
-       returnValue = !!returnValue;\r
-       \r
-       this.callFlash("ReturnUploadStart", [returnValue]);\r
-};\r
-\r
-\r
-\r
-SWFUpload.prototype.uploadProgress = function (file, bytesComplete, bytesTotal) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("upload_progress_handler", [file, bytesComplete, bytesTotal]);\r
-};\r
-\r
-SWFUpload.prototype.uploadError = function (file, errorCode, message) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("upload_error_handler", [file, errorCode, message]);\r
-};\r
-\r
-SWFUpload.prototype.uploadSuccess = function (file, serverData, responseReceived) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("upload_success_handler", [file, serverData, responseReceived]);\r
-};\r
-\r
-SWFUpload.prototype.uploadComplete = function (file) {\r
-       file = this.unescapeFilePostParams(file);\r
-       this.queueEvent("upload_complete_handler", file);\r
-};\r
-\r
-/* Called by SWFUpload JavaScript and Flash functions when debug is enabled. By default it writes messages to the\r
-   internal debug console.  You can override this event and have messages written where you want. */\r
-SWFUpload.prototype.debug = function (message) {\r
-       this.queueEvent("debug_handler", message);\r
-};\r
-\r
-\r
-/* **********************************\r
-       Debug Console\r
-       The debug console is a self contained, in page location\r
-       for debug message to be sent.  The Debug Console adds\r
-       itself to the body if necessary.\r
-\r
-       The console is automatically scrolled as messages appear.\r
-       \r
-       If you are using your own debug handler or when you deploy to production and\r
-       have debug disabled you can remove these functions to reduce the file size\r
-       and complexity.\r
-********************************** */\r
-   \r
-// Private: debugMessage is the default debug_handler.  If you want to print debug messages\r
-// call the debug() function.  When overriding the function your own function should\r
-// check to see if the debug setting is true before outputting debug information.\r
-SWFUpload.prototype.debugMessage = function (message) {\r
-       if (this.settings.debug) {\r
-               var exceptionMessage, exceptionValues = [];\r
-\r
-               // Check for an exception object and print it nicely\r
-               if (typeof message === "object" && typeof message.name === "string" && typeof message.message === "string") {\r
-                       for (var key in message) {\r
-                               if (message.hasOwnProperty(key)) {\r
-                                       exceptionValues.push(key + ": " + message[key]);\r
-                               }\r
-                       }\r
-                       exceptionMessage = exceptionValues.join("\n") || "";\r
-                       exceptionValues = exceptionMessage.split("\n");\r
-                       exceptionMessage = "EXCEPTION: " + exceptionValues.join("\nEXCEPTION: ");\r
-                       SWFUpload.Console.writeLine(exceptionMessage);\r
-               } else {\r
-                       SWFUpload.Console.writeLine(message);\r
-               }\r
-       }\r
-};\r
-\r
-SWFUpload.Console = {};\r
-SWFUpload.Console.writeLine = function (message) {\r
-       var console, documentForm;\r
-\r
-       try {\r
-               console = document.getElementById("SWFUpload_Console");\r
-\r
-               if (!console) {\r
-                       documentForm = document.createElement("form");\r
-                       document.getElementsByTagName("body")[0].appendChild(documentForm);\r
-\r
-                       console = document.createElement("textarea");\r
-                       console.id = "SWFUpload_Console";\r
-                       console.style.fontFamily = "monospace";\r
-                       console.setAttribute("wrap", "off");\r
-                       console.wrap = "off";\r
-                       console.style.overflow = "auto";\r
-                       console.style.width = "700px";\r
-                       console.style.height = "350px";\r
-                       console.style.margin = "5px";\r
-                       documentForm.appendChild(console);\r
-               }\r
-\r
-               console.value += message + "\n";\r
-\r
-               console.scrollTop = console.scrollHeight - console.clientHeight;\r
-       } catch (ex) {\r
-               alert("Exception: " + ex.name + " Message: " + ex.message);\r
-       }\r
-};\r
-</pre>    \r
-</body>\r
-</html>
\ No newline at end of file