Expands the range so that partial units are completely contained.
Syntaxvar retval = TextRange.expand(Unit);
There are no standards that apply here.
- Unit [in]
String that specifies the units to move in the range, using one one of the following values:
Expands a character.
Expands a word. A word is a collection of characters terminated by a space or another white-space character, such as a tab.
Expands a sentence. A sentence is a collection of words terminated by an ending punctuation character, such as a period.
Expands to enclose the entire range.
Return valueType: Boolean
Boolean that returns one of the following values:
The range was successfully expanded.
The range was not expanded.
This feature might not be available on non-Microsoft Win32 platforms.
This example creates a range from the current selection and uses the expand method to ensure that any word partially enclosed in the range becomes entirely enclosed in the range.
var rng = document.selection.createRange(); rng.expand("word");
Build date: 11/8/2012