Метод Range.StartOf (Word)

Статья
04/07/2023

Перемещает или расширяет начальную позицию указанного диапазона или выделенного фрагмента до начала ближайшей указанной текстовой единицы. Этот метод возвращает значение Long , указывающее количество символов, на которое был перемещен или расширен диапазон или выделенный фрагмент. Метод возвращает отрицательное число, если перемещение выполняется в обратном направлении по документу.

Синтаксис

выражение. StartOf( _Unit_ , _Extend_ )

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Единицы	Необязательный	WdUnits	Единица, на которую перемещается начальная позиция указанного диапазона или выделенного фрагмента. Может быть любой константой WdUnits, кроме wdLine. Значение по умолчанию — wdWord.
Extend	Необязательный	WdMovement	Указывает, следует ли перемещать или расширять начало диапазона. При использовании wdMove оба конца диапазона или выделенного фрагмента перемещаются в начало указанной единицы. При использовании wdExtend начало диапазона или выделенного фрагмента расширяется до начала указанной единицы. Значение по умолчанию — wdMove.

Замечания

Если начало указанного диапазона или выделенного фрагмента уже находится в начале указанной единицы измерения, этот метод не перемещает или не расширяет диапазон или выделение. Например, если выделение находится в начале строки, в следующем примере возвращается значение 0 (ноль) и выделение не изменяется.

char = Selection.StartOf(Unit:=wdLine, Extend:=wdMove)

Пример

В этом примере текст выделяется из точки вставки в начало строки. Количество выбранных символов хранится в charmoved.

Selection.Collapse Direction:=wdCollapseStart charmoved = Selection.StartOf(Unit:=wdLine, Extend:=wdExtend)

В этом примере выделение перемещается в начало абзаца.

Selection.StartOf Unit:=wdParagraph, Extend:=wdMove

В этом примере myRange перемещается в начало второго предложения в документе ( myRange свернут и расположен в начале второго предложения). В примере используется метод Select для отображения расположения myRange.

Set myRange = ActiveDocument.Sentences(2) 
myRange.StartOf Unit:=wdSentence, Extend:=wdMove 
myRange.Select

См. также

Объект Range

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

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