item Method

Internet Development Index

Retrieves an object from the filters collection or various other collections.

Syntax

oItem = object.item(vIndex)

Parameters

vIndex Required. Integer or String that specifies the object or collection to retrieve. If this parameter is an integer, it is the zero-based index of the object. If this parameter is a string, all objects with matching name or id properties are retrieved, and a collection is returned if more than one match is made.

Return Value

Returns an object or a collection of objects if successful, otherwise null.

Examples

The following example uses the item method to retrieve each object from the document. In this case, the method parameter is a number, so the objects are retrieved in the order in which they appear in the document.

<SCRIPT LANGUAGE="JScript">
var oItem = document.all;
if (oItem!=null) {
for (i=0; i<oItem.length; i++)
alert(oItem.item(i).tagName);
}
</SCRIPT>

The next example uses the item method to retrieve a collection of all objects in the document that have "Sample" as an ID. It then uses item again to retrieve each object from the "Sample" collection.

<SCRIPT LANGUAGE="JScript">
var oItem = document.all.item("Sample");
If (oItem != null) {
for (i=0; i<oItem.length; i++) {
alert(oItem.item(i).tagName);
}
}
</SCRIPT>

Standards Information

There is no public standard that applies to this method.

Applies To

filters, frames, imports, styleSheets, TextRange, TextRectangle