MultiPowUpload 1.5 control documentation

MultiPowUpload object properties 

---

fileList property

FileReference object

selectedIndices property

selectedItems property

fileList (Flash.fileList property)

An array of FileReference objects.

When the browseFiles() method has been called and the user has selected one or more files from the dialog box opened by browseFiles(), this property is populated with an array of FileReference objects, each of which represents a file the user selected.

The properties of FileReference objects are described in the FileReference class documentation.

Example

The following example demonstrates the fileList property.

function MultiPowUpload_onMovieLoad() { Flash.browseFiles(); } function MultiPowUpload_onSelect() { //Show selected files info var list = Flash.fileList(); for(var i=0; i<list.length; i++) { window.alert("File " + list[i].name + " was selected"); } }

FileReference (Flash.fileList[index] property)

Property summary

Property	Description
creationDate:Date [read-only]	The creation date of the file on the local disk.
creator:String [read-only]	The Macintosh creator type of the file. In Windows, this property is null.
modificationDate:Date [read-only]	The date that the file on the local disk was last modified.
name:String [read-only]	The name of the file on the local disk.
size:Number [read-only]	The size of the file on the local disk, in bytes.
type:String [read-only]	The file type. In Windows, this property is the file extension. On the Macintosh, this property is the four-character file type.

Example

The following example retrieves some info of a files selected by the user

function MultiPowUpload_onMovieLoad() { Flash.browseFiles(); } function MultiPowUpload_onSelect() { //Show selected files info var list = Flash.fileList(); for(var i=0; i<list.length; i++) { window.alert("File " + list[i].name + " (" + list[i].size + " bytes) created: " + Date(list[i].creationDate).toString() + " is in list"); } }

selectedIndices (Flash.selectedIndices property)

An array of Integer values.

Description

Property (read-only); an array of indices of the selected items.

The selectedIndices property reflects the order in which the items were selected. If you click the second item, then the third item, and then the first item, selectedIndices returns [1,2,0]. The value is null if nothing is selected.

Example

The following example retrieves the selected indices and names of a files selected:

function MultiPowUpload_onListChange() { var selIndices = Flash.selectedIndices(); if(selIndices!=null) { for(var i=0; i<selIndices.length; i++) { window.alert("File " + Flash.fileList()[selIndices[i]].name + " is selected in list"); } } }

selectedItems (Flash.selectedItems property)

An array of FileReference objects.

Description

Property (read-only); an array of the selected item objects. In a multiple-selection list, selectedItems lets you access the set of items selected as item objects. The value is null if nothing is selected.

Example

The following example counts total size of the selected files:

function MultiPowUpload_onListChange() { var selItems = Flash.selectedItems(); if(selItems!=null) { var totalSize = 0; for(var i=0; i<selItems.length; i++) { totalSize += selItems[i].size; } window.alert("Total size of a files selected is " + totalSize + " bytes."); } }

---