TextRectangle Collection

Internet Development Index

---

A collection of TextRectangle objects returned by the getClientRects method.

Members Table

The following table lists the members exposed by the TextRectangle object. Click a tab on the left to choose the type of member you want to view.

Attributes/Properties

Property	Description
length	Sets or retrieves the number of objects in a collection.

Methods

Method	Description
item	Retrieves an object from the filters collection or various other collections.
namedItem	Retrieves an object or a collection from the specified collection.

Remarks

The collection returns an empty collection for objects that do not have text.

If the window is resized, the collection is not updated. Because the collection is a snapshot of the layout, always update the collection following the onresize event.

The TextRectangle collection is available as of Internet Explorer 5.

Example

This example shows how to use the getClientRects method and the TextRectangle collection to iterate through the lines of text in an object.

<SCRIPT>
function newHighlite(obj) {
oRcts = obj.getClientRects();
iLength = oRcts.length
for (i = 0;i < iLength; i++)
{
alert("Line number " + (i + 1) + " is " +
(oRcts(i).right - oRcts(i).left) + " pixels wide.")
}
}
</SCRIPT>

Standards Information

There is no public standard that applies to this collection.

See Also

TextRectangle