document.importFile()

Availability

Flash 8.

Usage

document.importFile(fileURI [, importToLibrary])

Parameters

fileURI

A string, expressed as a file:/// URI, that specifies the path of the file to import.

importToLibrary

A Boolean value that specifies whether to import the file only into the document’s library (true) or to also place a copy on the Stage (false). The default value is false.

Returns

Nothing.

Description

Method; imports a file into a document. This method performs the same operation as the Import To Library or Import To Stage menu command. To import a publish profile, use document.importPublishProfile().

Example

The following example lets the user browse for a file to import onto the Stage:

var dom = fl.getDocumentDOM();  
var URI = fl.browseForFileURL("select", "Import File"); 
dom.importFile(URI);

See also

document.importSWF(), fl.browseForFileURL()