beautypg.com

Dreamweaver.browseforfolderurl() – Adobe Dreamweaver API Reference CS5 User Manual

Page 257

background image

252

DREAMWEAVER API REFERENCE

Document

Last updated 8/27/2013

You can specify the extensions as

.xxx[;.yyy;.zzz]

or

CCCC

:

.xxx

specifies the filename extension for the file type. Use

.yyy

and

.zzz

to specify multiple filename

extensions.

CCCC

is the four-character file type constant for Macintosh.

The following example provides two filters in your Select dialog, one for mp3 files and one for All Files:

dw.browseForFileURL("select", "Please select an mp3",false, true, new Array("mp3 Files
(*.MP3)|*.mp3||","All Files (*.*)|*.*||"));

The

startFolder

argument is a string value that can be used to specify the file URL of the folder in which the

search begins. If this argument is not specified, then the search begins from the last directory that was used. This
argument is optional.

The

allowDynamic

argument is a Boolean value that indicates whether to allow dynamic URLs or parameters. If

the value of this argument is

true

, it indicates that dynamic URLs or parameters are allowed. This argument is

optional.

The

fileToLocate

argument is a string value that is used to specify the file URL of the file you want to locate. This

argument is optional.

Returns
A string that contains the name of the file expressed as a file://URL.

dreamweaver.browseForFolderURL()

Availability
Dreamweaver 3.

Description
Opens the Choose Folder dialog box with the specified label in the title bar.

Arguments
{titleBarLabel}, {directoryToStartIn}

The titleBarLabel argument is the label that should appear in the title bar of the dialog box. If it is omitted, the
titleBarLabel argument defaults to Choose Folder.

The directoryToStartIn argument is the path where the folder should open, which is expressed as a file:// URL.

Returns
A string that contains the name of the folder, which is expressed as a file:// URL.

Example
The following code returns the URL of a folder:

return dreamweaver.browseForFolderURL('Select a Folder', ¬

dreamweaver.getSiteRoot());