Adobe 38040334 API Reference - Page 255

DREAMWEAVER CS3 250 API Reference 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: • "" • "" • "" dreamweaver.getPreferenceInt() Availability Dreamweaver MX. Description Lets you retrieve an integer preference setting for an extension.