TextRange

HTML (DHTML)

TextRange Collection

Retrieves a collection of TextRange objects.

Syntax

[ oColl = ] selection.TextRange
[ oObject = ] selection.TextRange(vIndex [, iSubIndex])

Possible Values

oColl Array of elements created with the createRangeCollection method.
oObject Reference to an individual item in the array of elements contained by the object.
vIndex Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndex Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.

Members Table

The following table lists the members exposed by the TextRange 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.

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

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

Elements can be accessed through the item method, or you can use an index to directly access an element in the collection. For example, the element returned from the collection represented by oColl(0) is the same as the element returned by oColl.item(0).
The TextRange collection is available as of Internet Explorer 5.5.

Standards Information

There is no public standard that applies to this collection.

Applies To

selection

oColl	Array of elements created with the createRangeCollection method.
oObject	Reference to an individual item in the array of elements contained by the object.
vIndex	Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndex	Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.