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 方案中的選擇性參數。