Dreamweaver.browseforfolderurl() – Adobe Dreamweaver API Reference CS5 User Manual
Page 257
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());