MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API, Reference

Page: 273 / 486

Global document functions 273
dreamweaver.getObjectTags() (deprecated)
Availability
Dreamweaver1; deprecated in 3.
Description
This function scans the specified document for instances of the specified tags or, if no tags are
specified, for all tags in the document. This function is equivalent to calling
getElementsByTagName()
and then getting
outerHTML
for each element in the
nodelist
.
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">"
000_DW_API_Print.book Page 273 Wednesday, August 20, 2003 9:14 AM