beautypg.com

Document.importfile() – Adobe Extending Flash Professional CS5 User Manual

Page 136

background image

114

EXTENDING FLASH PROFESSIONAL

Document object

Last updated 5/2/2011

Usage

document.id

Description
Read-only property; a unique integer (assigned automatically) that identifies a document during a Flash session. Use
this property in conjunction with

fl.findDocumentDOM()

to specify a particular document for an action.

Example
The following example displays the document ID for the current document:

fl.trace("Current doc's internal ID is: " + fl.getDocumentDOM().id);

See also

fl.findDocumentDOM()

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()

This manual is related to the following products: