User Guide

File manipulation functions 305
dreamweaver.browseForFileURL()
Availability
Dreamweaver 1, enhanced in 2, 3, and 4.
Description
Opens the specified type of dialog box with the specified label in the title bar.
Arguments
openSelectOrSave, {titleBarLabel}, {bShowPreviewPane}, ¬
{bSupressSiteRootWarnings}, {arrayOfExtensions}
■ The openSelectOrSave argument is a string that indicates the type of dialog box as
"
open", "select", or "save".
■ The titleBarLabel argument (added in Dreamweaver 2) is the label that should appear
in the title bar of the dialog box. If this argument is omitted, Dreamweaver uses the
default label that the operating system supplies.
■ The bShowPreviewPane argument (added in Dreamweaver 2) is a Boolean value that
indicates whether to display the Image Preview Pane in the dialog box. If this argument is
a value of
true, the dialog box filters for image files; if omitted, it defaults to a value of
false.
■ The bSupressSiteRootWarnings argument (added in Dreamweaver 3) is a Boolean
value that indicates whether to suppress warnings about the selected file being outside the
site root. If this argument is omitted, it defaults to a value of
false.
■ The arrayOfExtensions argument (added in Dreamweaver 4) is an array of strings for
specifying default content for the Files of type list menu at the bottom of the dialog box.
The proper syntax is
menuEntryText|.xxx[;.yyy;.zzz]|CCCC|, where menuEntryText
is the name of the file type to appear. The extensions can be specified as
.xxx[;.yyy;.zzz] or CCCC, where .xxx specifies the file extension for the file type
(optionally,
.yyy and .zzz specify multiple file extensions) and CCCC is the four-character
file type constant for the Macintosh.
Returns
A string that contains the name of the file, which is expressed as a file:// URL.
000_DW_API_Print.book Page 305 Wednesday, July 20, 2005 11:58 AM