共用方式為

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 命名空間