Range.Collapse Method

  • Article
Word Developer Reference

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.

Syntax

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.

Remarks

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.

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

Example

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.

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

See Also