expand Method

Expands the range so that partial units are completely contained.

Syntax

bSuccess = TextRange .expand( sUnit )

Parameters

sUnit

Required. String that specifies the units to move in the range, using one one of the following values:

character	Expands a character.
word	Expands a word. A word is a collection of characters terminated by a space or another white-space character, such as a tab.
sentence	Expands a sentence. A sentence is a collection of words terminated by an ending punctuation character, such as a period.
textedit	Expands to enclose the entire range.

Return Value

Boolean that returns one of the following values:

true	The range was successfully expanded.
false	The range was not expanded.

Remarks

This feature might not be available on non-Microsoft® Win32® platforms.

Example

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");

Standards Information

There is no public standard that applies to this method.

Applies To

[ Object Name ] Platform Version

Win16:
Win32:
Windows CE:
Unix:
Mac:

TextRange

Home | Top | Free Ajax Editor | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→