createRangeCollection method

Creates a TextRange object collection from the current selection.

Syntax

var retval = selection.createRangeCollection();

Parameters

This method has no parameters.

Return value

Type: Object

Returns a collection of TextRange objects.

Standards information

There are no standards that apply here.

Remarks

Host applications can provide a multiple selection mechanism and can return a collection of TextRange objects that represents discontinuous selections.

The host application provides the collection through the ISegmentList interface. MSHTML requests this interface through the ISelectionServices interface.

Microsoft Internet Explorer 5.5 does not provide multiple selection. The default implementation of this method returns a collection consisting of a single TextRange object.

Examples

The following example displays the text of the first selected item.

JavaScript


var myCollection;
myCollection = document.selection.createRangeCollection();
alert( myCollection.item(0).text );