Bookmark.MoveEndWhile(Object, Object) 方法

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

只要在文档中找到任意指定字符，就移动 Bookmark 控件的结束字符位置。

public int MoveEndWhile (ref object cset, ref object count);

abstract member MoveEndWhile : obj * obj -> int

Public Function MoveEndWhile (ByRef cset As Object, Optional ByRef count As Object) As Integer

参数

cset

Object

一个或多个字符。 此参数区分大小写。

count

Object

要将 Bookmark 控件移动的最大字符数。 可以是一个数字，也可以是 wdForward 或 wdBackward 常数。 如果 Count 是正数，则 Bookmark 控件在文档中向前移动。 如果是负数，Bookmark 控件将向后移动。 默认值为 wdForward。

返回

Int32

Bookmark 控件的结束位置被移动的字符数。 如果未找到 Cset 字符，则不会更改 Bookmark 控件，并且该方法返回 0（零）。

示例

下面的代码示例将包含文本的控件添加到第一 Bookmark 个段落，然后将另一个 Bookmark 控件添加到第一个书签中的第三个单词。 然后，代码移动第二个书签的范围，同时它可以找到字符 b、o、k、m、a、r 或 k。

此示例适用于文档级自定义项。

private void BookmarkMoveEndWhile()
{
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = "bookmark";

    bookmark2.MoveEndWhile(ref cSet, ref Count);
}

Private Sub BookmarkMoveEndWhile()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This is sample bookmark text."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveEndWhile("bookmark", Bookmark1.Characters.Count)
End Sub

注解

在 中找到 中的任何 Cset 字符时，将移动控件的 Bookmark 结束位置。

如果结束位置向后移动到原始起始位置之前的点，则起始位置将设置为新的结束位置。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。