controlRange

HTML (DHTML)

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

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

Methods

MethodDescription
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/>
...
This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this collection.

See Also

createControlRange, createRange