MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API, Reference

Page: 254 / 486

254 Chapter 14: Document
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.
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.
000_DW_API_Print.book Page 254 Wednesday, August 20, 2003 9:14 AM