domObj.getObjectsByTagValue

(Merge only)  (As of 3.2.001.03) 

Find all objects in the current DOM which match a specified tag name with a specified value.

Syntax

domObj.getObjectsByTag(tag, value)

Parameters 

tag is a tag name to search for (case insensitive).

value is a tag value to compare with (case insensitive).

Returned Value

It returns a JavaScript array of pointers to DocOrigin DOM objects. That array is empty if no matches are found.

Background

This routine searches only the current object (typically the object containing this script) as well as all objects within (under) this object.

Example

var p = getObjectsByTagValue('TagName', 'TagValue');

for(i=0; i<p.length; i++) {
	_logf("%d. name='%s' value='%s'", i, p[i]._name, p[i]._value);
}

The above script will generate a listing of all objects with tag name TagName and value TagValue. If this script is put on a top-level object (Form, Page, Container,) then all instances are found. If it occurs on a lower-level Pane it will only find the instances within that Pane.

See Also

domObj.getObjectsByTag
domObj.getObjectsByType
domObj.getObjectsByName