fl.browseForFileURL()

Availability

Flash MX 2004.

Usage

fl.browseForFileURL(browseType [, title [, previewArea]])

Parameters

browseType A string that specifies the type of file browse operation. Acceptable values are "open", "select" or "save". The values "open" and "select" open the system File Open dialog box. Each value is provided for compatibility with Dreamweaver. The value "save" opens a system File Save dialog box.

title A string that specifies the title for the File Open or File Save dialog box. If this parameter is omitted, a default value is used. This parameter is optional.

previewArea An optional parameter that is ignored by Flash and Fireworks and is present only for compatibility with Dreamweaver.

Returns

The URL of the file, expressed as a file:/// URI; returns null if the user cancels out of the dialog box.

Description

Method; opens a File Open or File Save system dialog box and lets the user specify a file to be opened or saved.

Example

The following example lets the user choose a FLA file to open and then opens the file. (The fl.browseForFileURL() method can browse for any type of file, but fl.openDocument() can open only FLA files.)

var fileURL = fl.browseForFileURL("open", "Select file");
var doc = fl.openDocument(fileURL);