TextRectangle Collection

Internet Development Index

A collection of TextRectangle objects returned by the getClientRects method.

Members Table

length Sets or retrieves the number of objects in a collection.
item Retrieves an object from the filters collection or various other collections.
namedItem   Retrieves an object or a collection from the specified collection.


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.


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

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.")

Standards Information

There is no public standard that applies to this collection.

See Also