MACROMEDIA DREAMWEAVER 8-DREAMWEAVER API, Reference

Page: 307 / 628

File manipulation functions 307
dreamweaver.createDocument()
Availability
Dreamweaver 2, enhanced in Dreamweaver 4.
Description
Depending on the argument that you pass to this function, it opens a new document either in
the same window or in a new window. The new document becomes the active document.
Arguments
{bOpenInSameWindow}, {type}
■
The
bOpenInSameWindow
argument is a Boolean value that indicates whether to open the
new document in the current window. If the
bOpenInSameWindow
argument is a value of
false
, if it is omitted, or if the function is called on the Macintosh, the new document
opens in a separate window.
■
The
type
argument specifies the type of document to create, as declared in the
Dreamweaver Configuration/DocumentTypes/MMDocumentTypes.xml file as the
id
attribute of the
documenttype
tag. For example, the
type
argument could be
"HTML",
"ASP-JS", "ASP-VB", "ColdFusion", "CFC", "JSP", "ASP.NET_VB"
, and so on. For
a complete list of possible types, see the MMDocumentTypes.xml file. If you do not
specify
type
, the value defaults to
"HTML"
.
Returns
The document object for the newly created document. This is the same value that the
dreamweaver.getDocumentDOM()
function returns.
NO
TE
This function can be called only from the menus.xml file, a command, or the Property
inspector file. If a behavior action or object tries to call this function, Dreamweaver
displays an error message.
NO
T
E
You can extend the MMDocumentTypes file by adding your own document types. For
information on extending document types, see
Extending Dreamweaver
.
000_DW_API_Print.book Page 307 Wednesday, July 20, 2005 11:58 AM