Bookmark.MoveUntil(Object, Object) 方法

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

移动 Bookmark 控件，直到在文档中找到指定字符之一。

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

abstract member MoveUntil : obj * obj -> int

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

参数

cset

Object

一个或多个字符。 如果在 值过期之前Count找到 中的任何Cset字符，控件Bookmark将作为紧邻该字符的插入点进行定位。 此参数区分大小写。

count

Object

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

返回

Int32

Bookmark 控件被移动的字符数。 如果 Count 大于 0（零），则此方法返回被移动的字符数加 1。 如果 Count 小于 0（零），则此方法返回被移动的字符数减 1。 如果未找到 Cset 字符，则不会更改 Bookmark 控件，并且该方法返回 0（零）。

示例

下面的代码示例将包含文本的控件添加到第一 Bookmark 个段落，然后将另一个 Bookmark 控件添加到第一个书签中的第三个单词。 然后，代码将移动第二个书签的范围，同时找到一个空白区域。

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

private void BookmarkMoveUntil()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    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 = " ";

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

Private Sub BookmarkMoveUntil()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    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.MoveUntil(" ", Bookmark1.Characters.Count)
End Sub

注解

折叠 Bookmark 为零长度的书签。

可选参数

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