A collection of TextRectangle objects returned by the getClientRects method.

Members Table

The following table lists the members exposed by the TextRectangle object.

Attributes/Properties

Show: Attributes/Properties Methods Prototypes

Property Description length Sets or retrieves the number of objects in a collection. Method Description item Retrieves an object from a TextRectangle collection. namedItem Retrieves an object or a collection from a specified collection. Object Description TextRectangleList Constructor   Defines the properties and methods inherited by objects in the TextRectangleList Constructor prototype chain.

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 Microsoft 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