MoveStartUntil Method

Microsoft Word Visual Basic

MoveStartUntil Method

       

Moves the start position of the specified range or selection until one of the specified characters is found in the document. If the movement is backward through the document, the range or selection is expanded.

Remarks

This method returns the number of characters by which the start position of the specified range or selection moved, as a Long value. If Count is greater than 0 (zero), this method returns the number of characters moved plus 1. If Count is less than 0 (zero), this method returns the number of characters moved minus 1. If no Cset characters are found, the specified range or selection isn't changed and the method returns 0 (zero). If the start position is moved forward to a point beyond the end position, the range or selection is collapsed and both the start and end positions are moved together.

expression.MoveStartUntil(Cset, Count)

expression   Required. An expression that returns an object in the Applies To list.

Cset   Required Variant. One or more characters. This argument is case sensitive.

Count   Optional Variant. The maximum number of characters by which the specified range or selection is to be moved. Can be a number or either the wdForward or wdBackward constant. If Count is a positive number, the range or selection is moved forward in the document. If it's a negative number, the range or selection is moved backward. The default value is wdForward.

Example

This example extends the selection backward until a capital "I" is found.

Selection.MoveStartUntil Cset:="I", Count:=wdBackward

If there's a dollar sign character ($) in the first paragraph in the selection, this example moves myRange just before the dollar sign.

Set myRange = Selection.Paragraphs(1).Range
leng = myRange.End - myRange.Start
myRange.Collapse Direction:=wdCollapseStart
myRange.MoveStartUntil Cset:="$", Count:=leng