beautypg.com

Dom.getisxhtmldocument(), Dreamweaver.browseforfileurl() – Adobe Dreamweaver API Reference CS5 User Manual

Page 256

background image

251

DREAMWEAVER API REFERENCE

Document

Last updated 8/27/2013

Example
In normal use, an extension first calls the

dreamweaver.openDocument()

or

dreamweaver.getDocumentDOM()

functions to get a reference to the document. The extension then calls the

dom.getIsXHTMLDocument()

function to

determine whether the document is already in XHTML form. If it is not, the extension calls the

dom.convertToXHTML()

function to convert the document into XHTML. Then the extension calls the

dreamweaver.saveDocument()

function to save the converted file with a new filename.

dom.getIsXHTMLDocument()

Availability
Dreamweaver MX.

Description
Checks a document (specifically, the

declaration) to see whether it is XHTML.

Arguments
None.

Returns
A

true

value if the document is XHTML;

false

otherwise.

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}, {startFolder}, {allowDynamic}, {fileToLocate}

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 appears 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 the value of this argument is

true

, the dialog box filters for image files;

if omitted, it defaults to

false

.

The

bSupressSiteRootWarnings

argument (added in Dreamweaver 3) is a Boolean value that indicates whether

to suppress warnings when the selected file is outside the site root. If this argument is omitted, it defaults to

false

.

The

arrayOfExtensions

argument (added in Dreamweaver 4) is an array of strings. It specifies the default content

for the Files of type list menu, which appears at the bottom of the dialog box. The syntax for this argument is

menuEntryText|.xxx[;.yyy;.zzz]|CCCC|

, where:

menuEntryText

is the name of the file type.