beautypg.com

Fl.browseforfolderurl() – Adobe Extending Flash Professional CS5 User Manual

Page 244

background image

222

EXTENDING FLASH PROFESSIONAL

flash object (fl)

Last updated 5/2/2011

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

See also

fl.browseForFolderURL()

fl.browseForFolderURL()

Availability
Flash 8.

Usage

fl.browseForFolderURL([description])

Parameters

description

An optional string that specifies the description of the Browse For Folder dialog box. If this parameter

is omitted, nothing is shown in the description area.

Returns
The URL of the folder, expressed as a file:/// URI; returns

null

if the user cancels out of the dialog box.

Description
Method; displays a Browse for Folder dialog box and lets the user select a folder.

Note: The title of the dialog box is always Browse for Folder. Use the

description

parameter to add more detail in the

description area under the title, such as “Select a folder” or “Select the path that contains the profile you want to import.”

This manual is related to the following products: