Export (0) Print
Expand All
Expand Minimize

Range.Collapse Method (Word)

Collapses a range or selection to the starting or ending position. After a range or selection is collapsed, the starting and ending points are equal.

expression .Collapse(Direction)

expression Required. A variable that represents a Range object.

Parameters

Name

Required/Optional

Data Type

Description

Direction

Optional

Variant

The direction in which to collapse the range or selection. Can be either of the following WdCollapseDirection constants: wdCollapseEnd or wdCollapseStart. The default value is wdCollapseStart.

If you use wdCollapseEnd to collapse a range that refers to an entire paragraph, the range is located after the ending paragraph mark (the beginning of the next paragraph). However, you can move the range back one character by using the MoveEnd method after the range is collapsed, as shown in the following example.

Set myRange = ActiveDocument.Paragraphs(1).Range 
myRange.Collapse Direction:=wdCollapseEnd 
myRange.MoveEnd Unit:=wdCharacter, Count:=-1

This example sets myRange equal to the contents of the active document, collapses myRange, and then inserts a 2x2 table at the end of the document.

Set myRange = ActiveDocument.Content 
myRange.Collapse Direction:=wdCollapseEnd 
ActiveDocument.Tables.Add Range:=myRange, NumRows:=2, NumColumns:=2

Concepts

Other resources

Show:
© 2014 Microsoft