item (TextRectangle)

item method

Retrieves an object from a TextRectangle collection.


var retval = TextRectangle.item(pvarIndex);


pvarIndex [in]

Type: Variant

Variant of type 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

Type: Variant

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

Standards information

There are no standards that apply here.


Always check the IDispatch pointer returned by this call, even if the method returns S_OK. If the value of the pointer is null, the element was not found and the call was not successful.


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 type="text/javascript">
var oItem = document.all;
if (oItem!=null) {
    for (i=0; i<oItem.length; i++) 

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 type="text/javascript">
var oItem = document.all.item("Sample");
If (oItem != null) {
    for (i=0; i<oItem.length; i++) {

See also




© 2016 Microsoft