controlRange Collection | Internet Development Index |
A collection of elements returned by the createControlRange or createRange method.
Members Table
The following table lists the members exposed by the controlRange 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 add Adds an element to the areas, controlRange, or options collection. addElement Adds an element to the controlRange collection. execCommand Executes a command on the current document, current selection, or the given range. item Retrieves an object from the controlRange collection. queryCommandEnabled Returns a Boolean value that indicates whether a specified command can be successfully executed using execCommand, given the current state of the document. queryCommandIndeterm Returns a Boolean value that indicates whether the specified command is in the indeterminate state. queryCommandState Returns a Boolean value that indicates the current state of the command. queryCommandSupported Returns a Boolean value that indicates whether the current command is supported on the current range. queryCommandValue Returns the current value of the document, range, or current selection for the given command. remove Removes an element from the collection. scrollIntoView Causes the object to scroll into view, aligning it either at the top or bottom of the window. select Makes the selection equal to the current object.
Remarks
Instead of using the collection's item method, 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 controlRange collection is available as of Microsoft® Internet Explorer 5.
Example
This example demonstrates how to use the createRange method to retrieve the controlRange collection.
... function fnChangeFontFamily (){ if (document.selection.type == "Control"){ var oControlRange = document.selection.createRange(); for (i = 0; i < oControlRange.length; i++) if (oControlRange(i).tagName != "IMG") oControlRange(i).style.fontFamily=event.srcElement.style.fontFamily; } } ... <!-- Text Font-Family Controls --> <SPAN onclick="fnChangeFontFamily();"> <DIV STYLE="height: 25px; cursor:hand; font-family:times; font-size:14pt; font-weight:normal; color:white">Times</DIV> <DIV STYLE="height: 25px; cursor:hand; font-family:arial; font-size:14pt; font-weight:normal; color:white">Arial</DIV> <DIV STYLE="height: 25px; cursor:hand; font-family:georgia; font-size:14pt; font-weight:normal; color:white">Georgia</DIV> <DIV STYLE="height: 25px; cursor:hand; font-family:verdana; font-size:14pt; font-weight:normal; color:white">Verdana</DIV> </SPAN><BR/> ...
Standards Information
There is no public standard that applies to this collection.
See Also
createControlRange, createRange