Selection.MoveWhile Method (Word)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Moves the specified selection while any of the specified characters are found in the document.

expression .MoveWhile(Cset, Count)

expression Required. A variable that represents a Selection object.

Parameters

Name

Required/Optional

Data Type

Description

Cset

Required

Variant

One or more characters. This argument is case sensitive.

Count

Optional

Variant

The maximum number of characters by which the specified selection is to be moved. Can be a number or either the wdForward or wdBackward constant. If Count is a positive number, the specified selection is moved forward in the document, beginning at the end position. If it is a negative number, the selection is moved backward, beginning at the start position. The default value is wdForward.

While any character in Cset is found, the specified selection is moved. The resulting Selection object is positioned as an insertion point after whatever Cset characters were found. This method returns the number of characters by which the specified selection was moved, as a Long value. If no Cset characters are found, the selection isn't changed and the method returns 0 (zero).

This example moves the selection after consecutive tabs.

Selection.MoveWhile Cset:=vbTab, Count:=wdForward
Show: