通过

Bookmark.MoveUntil 方法

  • 项目

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

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Function MoveUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveUntil(
    ref Object cset,
    ref Object count
)

参数

  • cset
    类型：System.Object%
    一个或多个字符。如果在 Count 值过期之前找到 Cset 中的任何字符，则 Bookmark 控件将作为插入点定位到紧靠该字符之前。此参数区分大小写。
  • count
    类型：System.Object%
    要将 Bookmark 控件移动的最大字符数。可以是一个数字，也可以是 wdForward 或 wdBackward 常数。如果 Count 是正数，Bookmark 控件将在文档中从结束位置开始向前移动。如果是负数，Bookmark 控件将从起始位置开始向后移动。默认值为 wdForward。

返回值

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

备注

Bookmark 折叠为一个零长度的书签。

可选参数

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

示例

下面的代码示例向第一个段落添加一个带有文本的 Bookmark 控件，然后向第一个书签中的第三个单词添加另一个 Bookmark 控件。 然后该代码只要能够找到空白区域，就移动第二个书签的范围。

此示例针对的是文档级自定义项。

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

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);
}

.NET Framework 安全性

请参见

参考

Bookmark 接口

Microsoft.Office.Tools.Word 命名空间