Метод Range.Collapse (Word)

Статья
04/07/2023

Сворачивает диапазон или выделенный фрагмент в начальную или конечную позицию. После сворачивания диапазона или выделения начальная и конечная точки равны.

Синтаксис

выражение. Collapse( _Direction_ )

выражение (обязательно). Переменная, представляющая объект Range .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Direction	Необязательный	Variant	Направление, в котором нужно свернуть диапазон или выделение. Может быть любой из следующих констант WdCollapseDirection : wdCollapseEnd или wdCollapseStart. Значение по умолчанию — wdCollapseStart.

Замечания

Если вы используете wdCollapseEnd для свертывания диапазона, ссылающегося на весь абзац, диапазон находится после конечной отметки абзаца (начало следующего абзаца). Однако можно переместить диапазон назад на один символ с помощью метода MoveEnd после свертывания диапазона, как показано в следующем примере.

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

Пример

В этом примере задается значение myRange, равное содержимому активного документа, свертывание myRange, а затем вставка таблицы 2x2 в конец документа.

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

См. также

Объект Range

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.