1 out of 2 rated this helpful - Rate this topic

How to: Collapse Ranges or Selections in Documents

Visual Studio 2005

Note
Some code examples in this topic use the this or Me keyword or the `Globals` class in a way that is specific to document-level customizations, or they rely on features of document-level customizations such as host controls. These examples can be compiled only if you have the required applications installed. For more information, see Features Available by Product Combination.

If you are working with a Range or Selection object, you might want to change the selection to an insertion point before inserting text, to avoid overwriting existing text. Both the Range and Selection objects have a Collapse method, which makes use of two WdCollapseDirection enumerations:

wdCollapseStart- collapses the selection to the beginning of the selection. This is the default if you do not specify an enumeration.
wdCollapseEnd - collapses the selection to the end of the selection.

To collapse a range and insert new text

Create a Range object consisting of the first paragraph in the document.
C#
VB
Copy
Word.Range rng = this.Paragraphs[1].Range;

Use the wdCollapseStart enumeration to collapse the range.

Copy

object direction = Word.WdCollapseDirection.wdCollapseStart;
rng.Collapse(ref direction);

Insert the new text.
C#
VB
Copy
rng.Text = " New Text ";
Select the Range.
C#
VB
Copy
rng.Select();

If you use the wdCollapseEnd enumeration, the text is inserted at the beginning of the following paragraph.

Copy

direction = Word.WdCollapseDirection.wdCollapseEnd;
rng.Collapse(ref direction);

You might expect that inserting a new sentence would insert it before the paragraph marker, but that is not the case because the original range includes the paragraph marker. For more information, see How to: Exclude Paragraph Marks When Creating Ranges.

The following example shows the complete method.

Example

Copy

Word.Range rng = this.Paragraphs[1].Range; 

object direction = Word.WdCollapseDirection.wdCollapseStart;
rng.Collapse(ref direction); 

rng.Text = " New Text ";
rng.Select();

How to: Collapse Ranges or Selections in Documents

To collapse a range and insert new text

Example

See Also

Tasks

Concepts

Other Resources