Selection.MoveStartUntil Method (Word)
Moves the start position of the specified selection until one of the specified characters is found in the document. If the movement is backward through the document, the selection is expanded.
Syntax
expression .MoveStartUntil(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 selection is moved forward in the document. If it is a negative number, the selection is moved backward. The default value is wdForward. |
Remarks
This method returns the number of characters by which the start position of the specified 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 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 selection is collapsed and both the start and end positions are moved together.
Example
This example extends the selection backward until a capital "I" is found.
Selection.MoveStartUntil Cset:="I", Count:=wdBackward