User Guide

Global document functions 329
Arguments
sourceDoc, {tag1}, {tag2},...{tagN}
■ The sourceDoc argument must be "document", "parent", "parent.frames[number]",
"parent.frames['frameName']", or a URL. The document value specifies the
document that has the focus and contains the current selection. The
parent value
specifies the parent frameset (if the currently selected document is in a frame), and
parent.frames[number] and parent.frames['frameName'] specify a document that
is in a particular frame within the frameset that contains the current document. If the
argument is a relative URL, it is relative to the extension file.
■ The second and subsequent arguments, if supplied, are the names of tags (for example,
"IMG", "FORM", "HR").
Returns
An array of strings where each array is the source code for an instance of the requested tag type
in the specified document.
■ If one of the tag arguments is LAYER, the function returns all LAYER and ILAYER tags and
all absolutely positioned
DIV and SPAN tags.
■ If one of the tag arguments is INPUT, the function returns all form elements. To get a
particular type of form element, specify
INPUT/TYPE, where TYPE is button, text,
radio, checkbox, password, textarea, select, hidden, reset, or submit.
When the same list of arguments passes to
getObjectRefs(), the two functions return arrays
of the same length.
Example
dreamweaver.getObjectTags("document", "IMG"), depending on the contents of the
active document, might return an array with the following items:
■ "<IMG SRC="/images/dot.gif" WIDTH="10" HEIGHT="10" NAME="bullet">"
■ "<IMG SRC="header.gif" WIDTH="400" HEIGHT="32" NAME="header">"
■ "<IMG SRC="971208_nj.jpg" WIDTH="119" HEIGHT="119" NAME="headshot">"
dreamweaver.getPreferenceInt()
Availability
Dreamweaver MX.
Description
Lets you retrieve an integer preference setting for an extension.
000_DW_API_Print.book Page 329 Wednesday, July 20, 2005 11:58 AM