createControlRange method

[This documentation is preliminary and is subject to change.]

Creates a controlRange collection of nontext elements.


IDispatch retVal = object.createControlRange();

Standards information

There are no standards that apply here.


This method has no parameters.


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.

See also




Build date: 6/12/2012

Community Additions