2 out of 8 rated this helpful - Rate this topic

createControlRange method

Creates a controlRange collection of nontext elements.

Syntax

var retval = body.createControlRange();

Standards information

There are no standards that apply here.

Parameters

This method has no parameters.

Return value

Type: Object

Returns a controlRange collection if sucessful or a null value otherwise.

Remarks

Creates a selection range object for control-based selection rather than text-based selection.

If a controlRange already exists, createControlRange overwrites the existing element; otherwise, it returns a pointer to the element created.

If there are currently controls selected in the text container, the control range is initialized with them; otherwise, it is created empty and controls need to be explicitly added to it. This is opposite of the text range, which defaults to the whole text container if there is no selection.

Examples

This example creates a controlRange by using the createControlRange method.


oControlRange = document.body.createControlRange();

See also

body
createRange

 

 

Send comments about this topic to Microsoft

Build date: 11/8/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.