MoveWhile 方法 (Word)Range.MoveWhile method (Word)

当在文档中找到任何指定的字符时,移动指定范围。Moves the specified range while any of the specified characters are found in the document.

语法Syntax

expressionexpression. MoveWhile( _Cset_ , _Count_ )

expression 是必需的。expression Required. 一个代表 Range 对象的变量。A variable that represents a Range object.

参数Parameters

名称Name 必需/可选Required/Optional 数据类型Data type 说明Description
CsetCset 必需Required VariantVariant 一个或多个字符。One or more characters. 此参数区分大小写。This argument is case-sensitive.
CountCount 可选Optional VariantVariant 最大指定范围内的移动的字符数。The maximum number of characters by which the specified range is to be moved. 可以是一个数字, 也可以是wdForwardwdBackward常量。Can be a number or either the wdForward or wdBackward constant. 如果 Count 是一个正数,则指定的区域在文档中从结束位置开始向前移动。If Count is a positive number, the specified range is moved forward in the document, beginning at the end position. 如果是负数,范围是从起始位置开始向后移动。If it is a negative number, the range is moved backward, beginning at the start position. 默认值是 wdForwardThe default value is wdForward.

备注Remarks

当找到 Cset 中的任何字符时,就移动指定的范围。While any character in Cset is found, the specified range is moved. 生成的Range对象在找到任何 Cset 字符之后作为一个插入点定位。The resulting Range object is positioned as an insertion point after whatever Cset characters were found. 此方法返回所指定的范围内移动,作为 Long 类型的值的字符数。This method returns the number of characters by which the specified range was moved, as a Long value. 如果没有找到 Cset 字符,则不改变范围,此方法返回 0 (零)。If no Cset characters are found, the range isn't changed and the method returns 0 (zero).

示例Example

如果找到以下任何字符 (大写或小写字母), 本示例将移动_aRange_ : "a"、"t" 或 "i"。This example moves aRange while any of the following (uppercase or lowercase) letters are found: "a", "t", or "i".

Dim aRange As Range 
Set aRange = ActiveDocument.Characters(1) 
aRange.MoveWhile Cset:="atiATI", Count:=wdForward

另请参阅See also

Range 对象Range Object

支持和反馈Support and feedback

有关于 Office VBA 或本文档的疑问或反馈?Have questions or feedback about Office VBA or this documentation? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.