Edit

Range.Collapse method (Word)

  • Article

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.

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.

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

See also

Range Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.