Метод Range.Move (Word)

  • Статья

Сворачивает указанный диапазон в начальную или конечную позицию, а затем перемещает свернутый объект на указанное количество единиц.

Синтаксис

выражение. Move( _Unit_ , _Count_ )

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

Параметры

Имя Обязательный или необязательный Тип данных Описание
Единицы Необязательный WdUnits Единица, на которую перемещается диапазон.
Count Необязательный Variant Количество единиц, на которые будет перемещен указанный диапазон. Если count является положительным числом, объект сворачивается до конечной позиции и перемещается в документе назад на указанное количество единиц. Если count является отрицательным числом, объект сворачивается в начальную позицию и перемещается вперед на указанное количество единиц. Значение по умолчанию равно 1. Вы также можете управлять направлением сворачивания с помощью метода Collapse перед использованием метода Move . Если диапазон находится в середине единицы или не свернут, перемещение его в начало или конец единицы считается перемещением на одну полную единицу.

Возвращаемое значение

Длинное целое

Замечания

Этот метод возвращает значение Long , указывающее количество единиц, на которое фактически был перемещен объект, или возвращает 0 (ноль), если перемещение было неудачным.

Начальная и конечная позиции свернутого диапазона равны.

Применение метода Move к диапазону не приводит к переупорядочению текста в документе. Вместо этого он переопределяет диапазон для ссылки на новое расположение в документе.

Пример

В этом примере для параметра Range1 задается первый абзац активного документа, а затем диапазон перемещается вперед на три абзаца. После выполнения этого макроса точка вставки размещается в начале четвертого абзаца.

Set Range1 = ActiveDocument.Paragraphs(1).Range 
With Range1 
 .Collapse Direction:=wdCollapseStart 
 .Move Unit:=wdParagraph, Count:=3 
 .Select 
End With

См. также

Объект Range

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

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